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inte PREFACE 


The NDS-II ISIS-III(N) User's Guide provides operating instructions for the Network 
Development System-II (NDS-II) Series 111, Series II, and Model 800 workstation. 
This manual assumes that you 


a * Have read the NDS-II Network Development System Overview (121761) 
e Understand how to use the Intellec Microcomputer Development System 


e Have read either the Intellec® Series III Microcomputer Development System 
Console Operating Instructions (121609) for Series III workstations, or the 
ISIS-II User's Guide (9800306) for Series II or Model 800 workstations 


This manual describes the capabilities of the NDS-II ISIS-III(N) workstation and 

Q its interaction with the NDS-II Network Resource Manager (МЕМ). The NDS-II 
Network Development System Overview and the NDS-II Network Resource Manager 
User's Guide (134300) contain information on the Network Development System-II 
and the NDS-II Network Resource Manager (МЕМ). 


For information on the Series IV workstation, refer to the /л/е ес? Series IV Micro- 
computer Development System Overview (121752), the Intellec? Series IV Operating 
and Programming Guide (121753), and the Intellec® Series IV ISIS-IV User's Guide 


О (121880). 


System operation requires version 2.1 or later of the ISIS-III(N) operating system 
software. 


This manual contains seven chapters and three appendixes: 

e Chapter 1, “Overview,” profiles the NDS-II ISIS-III(N) workstation. 

e Chapter 2, "NDS-II File Structure,” describes the NDS- П distributed file system 

О and how it differs from the ISIS-II file structure. 

e Chapter 3, "NDS-II File Management,” offers guidelines for using the NDS-II 
file structure for particular applications and projects. 

* Chapter 4, “Workstation Commands," defines and provides examples of 
commands necessary to access the network. 


E * Chapter 5, Workstation System Calls," describes the changes to existing ISIS 
system calls and the new system calls designed to take advantage of the network 
capabilities. 

* Chapter 6, "System Considerations," offers suggestions for improving system 
performance. 

e Chapter 7, “Error Messages,” lists and explains all new 1515-ПІ(М) error 
messages and indicates appropriate user action. 

e Appendix A, "Summary of Error Messages," lists all error codes and messages. 


* Appendix B, “Summary of ISIS-III(N) Commands Syntax," lists ISIS-III(N) 
commands and their syntax. 


Q e Appendix C, “Summary of ISIS-III(N) Devices,” lists the devices that аге 
supported by the ISIS-III(N) operating system. 
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Related Publications 


For more information on the NDS-II Network Development System, refer to the 
following manuals: 


*  NDS-II Network Development System Overview (121761) 
e NDS-II Network Resource Manager User's Guide (134300) 


• iMDX 455 Network Workstation Upgrade Kit Installation and Checkout Manual 
(121882) 


For a Series IV workstation: 

e Intellec? Series IV Microcomputer Development System Overview (121752) 
e Intellec? Series IV Operating and Programming Guide (121753) 

“ Intellec? Series IV ISIS-IV User's Guide (121880) 


For a Series III workstation: 


e [ntellec?. Series ПІ Microcomputer Development System Product Overview 
(121565) 


*  Intellec? Series ІП Microcomputer Development System Console Operating 
Instructions (121609) 


*  Intellec? Series ІП Microcomputer Development System Programmer's 
Reference Manual (121618) 


*  ISIS-II User's Guide (9800306) 


For a Series П or Model 800 workstation: 
• 15818-11 User's Guide (9800306) 


Notational Conventions 


UPPERCASE Characters shown in uppercase must be entered in the order 
shown. You may enter the characters in uppercase or 
lowercase. 

italic Italic indicates a meta symbol that may be replaced with an 


item that fulfills the rules for that symbol. The actual symbol 
may be any of the following: 


directory-name Is that portion of a pathname that acts as a file locator by 
identifying the device and/or directory containing the 
filename. 

filename Is a valid name for the part of a pathname that names a file. 

pathname Is a valid designation for a file; in its entirety, it consists of a 


directory and a filename. 


Vxy Is a generic label placed on sample listings where the version 
number of the product that produced the listing would 
actually be printed. 


D.) Brackets indicate optional arguments or parameters. 
(o One and only one of the enclosed entries must be selected 


unless the field is also surrounded by brackets, in which case 
it is optional. 
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Uso 


punctuation 


«cr»? 


shading 


At least one of the enclosed items must be selected unless the 
field is also surrounded by brackets, in which case it is 
optional. The items may be used in any order unless other- 
wise noted. 


Ellipses indicate that the preceding argument or parameter 
may be repeated. 


The preceding item may be repeated, but each repetition must 
be separated by a comma. 


Punctuation other than ellipses, braces, and brackets must be 
entered as shown. For example, the punctuation shown in the 
following command must be entered: 


SUBMIT PLM86(PROGA,SRC,'9 SEPT 817) 


In interactive examples, user input lines are printed in white 
on black to differentiate them from system output. 


Indicates a carriage return. 


Shading in Chapters 4 and 5 highlights the differences 
between ISIS-III(N) software and ISIS-II. 
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CHAPTER 1 


OVERVIEW 


This chapter provides an overview of NDS-II ISIS-III(N) workstations. Functions of 
the ISIS-III(N) operating system are described. 


The NDS-II Network 


The NDS-II is ап Ethernet-based interconnection of development systems. This 
connection allows multiple users to share concurrent access to a central hard disk(s), 
public workstations, and an optional spooled line printer. The NDS-II Network offers 
a remote network hard disk sub-system. 


For more information on the NDS-II Network, see the NDS-II Network Develop- 
ment System Overview (121761). 


The NDS-Il Workstation 


The NDS-II workstation communicates with the NDS-II Network Resource Manager 
(МАМ) through the Communications Controller Board set located in the worksta- 
tions and the Network Resource Manager. Cables connect the workstations and the 
NRM to the Intellink Communications Module (see figure 1-1). Workstations also 
can be connected to the Network via an Ethernet cable. A single transceiver connects 
the Intellink Communications Module to the Ethernet cable (see figure 1-2 later in 
this chapter). 


Each workstation functions as a standalone development system for any tasks that do 
not require NRM resources. When network resources are required, the workstation 
can be logged on to the Network. While logically connected to the Network, the 
Intellec development system operates as a standard development system. Addition- 
ally, the Network provides the workstation access to the shared network files, the 
NDS-II Network Line Printer, and the remote job execution utilities. 


ISIS-III(N) is the operating system that executes on the NDS-II Series III, Series 
П, and Model 800 workstation. This operating system offers the ISIS environment 
and provides additional functionality to take advantage of the NDS-II network 
capabilities: 


e Network based hierarchical file system integrated with local ISIS file structure 


e Controlled access to the network file system through user identification and 
verification 


* Distributed job control (DJC) that allows user-specified batch jobs to be executed 
on idle development systems that have been made public with the IMPORT 
command 


e Access to a spooled line printer queue (:SP:) 
* А utility to monitor the network communication system 
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О NDS-II Terminology 


The NDS-II Network Development System Overview (121761) has a complete 
glossary of NDS-II terminology. A more detailed description of some terms frequently 


encountered with ISIS-III(N) follows. 


Hardware 


The iMDX 455 Ethernet Workstation Upgrade Kit Installation and Checkout Manual 
(121882) describes the hardware connection of the workstation and the NRM. 
Communications Controller Board Set 

The NDS-II Communications Controller Board Set, located in the workstation, and 
the Network Resource Manager enable the stations to communicate through the 
Intellink Communications Module. 

Intellink" Communications Module 

The Intellink Communications Module is the self-contained hardware box that 
provides an Ethernet compatible interconnection. It supports collision detect, 10 Mbps 


operation, and has an independent power supply. It can be used as a standalone system 
or it can be connected to a full network. 


Q Files and Directories 


The distributed file system of NDS-II introduces several ways to describe network 
files. These new terms are defined below. 


Data Files 


A data file can contain only data. Data files cannot contain another data file or a 
directory file. 


Q Directory Files 


A directory file is a logical collection of files stored on the disk. Directory files can 
contain data files or other directory files. 


. Local Files 


Local files are data and directory files that reside on flexible disks at the local, flexi- 
. ble disk drives of the workstation. 


Private Files 


Private files are local or remote files accessible only to the file owner. 


Public Files 


О Public files are remote files accessible to the owner and any other network user. 
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Remote Files 


Remote files are data and directory files that reside in the public file system at the 
Network Resource Manager. 


Shared Files 


Shared files reside only in the public file system. АП shared files in directories must 
have unique names. The pathname to the directory must uniquely define the direc- 
tory and any shared file in the system. Shared files within the directory can be declared 
accessible to other network users by setting the appropriate access switches (see 
Chapter 4). 


Hierarchical File Structure 
The NDS-II public file structure is hierarchical. It can contain more than one direc- 


tory and many data files. Chapters 2 and 3 describe the hierarchical (or inverted 
tree) file structure in more detail. 


Remote Job Execution 


The NDS-II distributed job control (DJC) allows jobs to be submitted and executed 
remotely. The NRM uses job queues to control the remote job execution. The NRM 
recognizes two types of workstations: public and private. 


Private Workstation 
Private workstations are logged on to the Network but can execute only their own 


jobs. However, private workstations can send jobs to the NRM to be executed by 
other public workstations. 


Public Workstation 


Public workstations are development systems that are logged on to the Network and 
can execute jobs sent from job queues by the Network Resource Manager. Any idle 
development system can be declared public with the IMPORT command. A public 
workstation accepts jobs only from the NRM. It cannot send jobs to the NRM. (See 
Chapter 4 of this manual.) 


Job Queues 


Users can create job queues for remote job execution with the QUEUE command. 


Network Access 


ISIS-HI(N) is the operating system for Series III, Series II, and Model 800 worksta- 
tions. This operating system provides ISIS-III(N) users with the ISIS environment, 
and with additional functionality for accessing the network and verifying the compat- 
ibility of command programs. 


Device Access 


Appendix C lists the devices that are accessible from the workstation executing 
ISIS-III(N). 
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File Access 


Users can access shared, network files using ISIS file-naming conventions with the 
ISIS-III(N) ASSIGN command. ASSIGN allows the user to represent network 
directory pathnames with directory identifiers. See Chapter 4 for a detailed descrip- 
tion of the capabilities and restrictions of the ASSIGN command. 


Logging On 


To access network directories or network devices, the user must be identified to the 
Network Resource Manager. The LOGON command logically connects network 
workstations to the Network Resource Manager and allows network access. 


Before the user can execute the LOGON command, ISIS-III(N) must be invoked. 
First, initialize the ISIS-III(N) operating system by turning on the workstation and 
disk drives. Then insert the system disk into disk drive 0. Next, press the RESET 
button, and the ISIS-III(N) sign-on message and prompt (-) appear. 


ISIS-IIICN) Vxy 


where 
Xy is the version and release number of ISIS-III(N). 


Entering Commands 


Users can enter commands at workstations whenever the ISIS-III(N) prompt (-) is 
displayed. Each ISIS-III(N) command is entered as a command line and must be 
terminated by a carriage return or a line feed. Line feeds are automatically entered 
when the RETURN key is pressed after command lines. See Chapter 4 of this manual 
for more details on the ISIS-III(N) commands. 


Logging Off 

The LOGOFF command logically disconnects workstations from the Network 
Resource Manager. See Chapter 4 for the LOGOFF command. 

Superuser 

The Superuser is the username assigned to the person designated as the network 
administrator. Some commands can be entered only by the Superuser at the NRM 
terminal. 

Username and Password 

The username/password combination enables users to access the NDS-II network 
resources, Usernames and passwords can be added or deleted by the Superuser at the 


Network Resource Manager (see the NDS-II Network Resource Manager User's 
Guide). 


CHAPTER 2 


М05-І FILE STRUCTURE 


This chapter describes the NDS-II distributed file system and the differences between 
it and the ISIS-II file structure. The NDS-II distributed file system offers a hierar- 
chical file structure that provides 


e Multiple user access to shared, network data and directory files 

e  Owner-controlled access (world and owner) to network files 

• А list of files that reside in the network directories 

• Тһе ability to create new directory and data files while other users are concur- 
rently accessing the network files 

e Flexibility in file maintenance 

• Ап archiving facility for files stored on the shared disk 

• Time and date stamping of network files at the МЕМ 


e Optional cartridge tape backup of network files 


In previous versions of ISIS-II, files and collections of files were tied to the media 
(disk) and the disk drive (physical device) where the files were stored. Because they 
were tied, the terms disk, directory; directory identifier, logical device name, physical 
device name, and disk drive were functionally identical and could be used 
interchangeably. 


Additional functionality of the NDS-II network requires redefinition of those terms. 
In this manual, the terms are used as follows: 


e  Disk—the media where directories of files can be stored 
e  Directory—a logical collection of files stored on a disk 
e Directory Name—a user-specified label for a directory (SYSTEM.DIR) 


e Directory Identifier—a label (:Fn:) that can be used to represent a network 
directory pathname (/WINCHI.VOL/DIRB), a physical device name (drive 1), 
or another directory identifier (:F3:) 


* Disk Drive—a machine used to access a directory stored on a disk 


* Physical Device Name—a label assigned to a physical device (line printer, drive 
1, console) 


* Logical Device Name—a label (:BB:, :CO:) assigned to a logical device (byte 
bucket, console output) 


NOTE 


Usernames, passwords, or remote directory names that have special 
characters can be used in ISIS-III(N) if the special characters are 
enclosed within single quotes. The quotes literalize characters that 
are not normally usable in the ISIS environment. Local directory 
names must conform to ISIS-II conventions. 


Directory identifiers can be assigned to physical devices or network directory 
pathnames or other directory identifiers. Default values for the physical device name 
assignments are listed in Chapter 4 of this manual. Directory identifiers can be altered 
with the ASSIGN command. 
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1515-1 File Structure Q 


The 1515-П file structure is based on a flat directory structure with one directory per 
disk (see figure 2-1). 


To access the data file FILEB.EXT, the user must enter :FI:FILEB.EXT. Every 
directory has one identifier (:Ел:), and every file within the directory is a data file. 
Each disk or volume can contain only one directory. 


NDS-II File Structure 


The NDS-II file structure is a hierarchical (or inverted tree) file structure. It can * 
contain more than one directory file and many data files (see figure 2-2). 


The Superuser names the volumes and assigns access rights to these volumes (see the 
NDS-II Network Resource Manager User's Guide). 


Types of Files 


Volumes can contain as many directory or data files as available storage will allow. 
Directory files can contain other directory files or data files. Data files contain only 
data. A data file cannot contain a directory file. 


User File Protection 


Remote network files in the hierarchical file structure have owner, world, and Q 
Superuser access rights that are controlled by access switches. These switches can be 

controlled (turned on and off) with the ACCESS command described in Chapter 4 

of this manual. 


Local files can be protected by controlling file attributes with the ATTRIB command. 


Pathnames 


Data and directory files can be traced down through the file structure by their О 
pathnames. The pathname identifies every volume and directory from the logical 

System root to the data file. For instance, /WINCHI.VOL/DIRB/FILE3.EXT is 

the pathname for data file FILE3.EXT in figure 2-2. 


Figure 2-1. ISIS File Structure 121765-2 О 
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because the slash (/) acts as a delimiter between the names of the volume and the 


© The pathname /WINCHI.VOL/DIRB/FILE3.EXT is a fully qualified pathname 
directories in the path along the “branches” of the “tree.” 


Accessing a File 


Workstations using ISIS-III(N) cannot directly access tree-structured directory files. 
However, the ASSIGN command allows the ISIS-III(N) user to access remote PY 
network files. The ASSIGN command uses directory identifiers to represent 

о pathnames. (See the ASSIGN command description in Chapter 4 of this manual.) 


To access the file FILE3.EXT in figure 2-2, use the ASSIGN command to assign a 
directory identifier (:Ел:) to the fully qualified pathname of the directory that contains 
FILE3.EXT. 

-ASSIGN :F1: TO /HINCH1.VOL/DIRB«cr» 


The pathname for this file is now :F1:FILE3.EXT. 


Creating Directories 


To create new directories in the hierarchical tree structure, use the CREATE , 
command described in Chapter 4 of this manual. The CREATE command allows 
users to add new directory files to existing directory files by specifying either the fully 

` qualified pathname (naming all of the branches of the tree) or the directory identifier 
assigned to the existing directory file. 
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CHAPTER 3 


NDS-Il FILE MANAGEMENT 


This chapter offers guidelines that will help you take advantage of the versatility and 
flexibility of the NDS-II distributed file system. 


Directory Maintenance Guidelines ; 


Guidelines you can use to create and maintain your directory and data files: 


1. Minimize the number of directories in each volume by subdividing the directories 
by project and function. 


2. Keep all "system files" in one directory file. 


3. Create a separate directory of directory files for individual user “miscellaneous 
files." 


The model in figure 3-1 illustrates a typical development environment. 


Logical System Root 


Тһе top of the diagram in figure 3-1 represents the logical system root of the 
NDS-II distributed file system. This root is where all volumes are connected together. 
You cannot add data or directory files to the logical system root. 


The root stores directory information for all volumes in the NDS-II system. 


Volumes 


Volumes are established during the System Generation process (see NDS-II Network 
Resource Manager User's Guide). Volumes can contain directory or data files. In 
this model, the volume WINCHI.VOL corresponds to the Winchester disk at the 
Network Resource Manager. 


Directory Files 


Directory files reside within each volume. Directory files can contain other directory 
files or data files. Figure 3-1 shows a volume (WINCHI.VOL) with five directory 
files: ISIS.SYS, PROJA.DIR, PROJB.DIR, JOHN.DIR, and SHEILA.DIR. 


The ISIS.SYS directory file contains all files that programmers would normally look 
for in the default directory: 


*  [SIS.SYS (basic system files ISIS.BIN, ISI.OVO, ISIS.OVI, ISIS.OV2, 
ISIS.CLI) 


* Command programs (COPY, RENAME, LOGON) 
e Text editors (CREDIT, AEDIT) 
e Compilers & Translators (PASC86.86, PLM86.86, ASM86.86, FORT86.86) 
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e Linkers and Locators (LINK86, LOC86) 


* Other tools 
e Latest stable version of prototype software 


The Superuser owns the ISIS.SYS file. To prevent accidental modification or deletion 
by system users, the world access rights are READ only. 


Project directories PROJA.DIR and PROJB.DIR contain directories that subdivide 
the project into phases or sections, depending on the application. Figure 3-1 shows 
the four directories contained in PROJA.DIR: 


*  PHASEI.DIR—-contains various stages of prototype software and all .SRC, .LST, 
.OBJ, and other work files related to this phase of the project. 


. PHASE2.DIR—similar to PHASEI.DIR, except that this directory is further 
subdivided for programmer convenience. 
• BACKUP.DIR—stores backup copies of all relevant project files. 


e  TEST.DIR—contains separate directories of tests for various aspects of the 
project. These directories each contain individual test files. 


The directory files listed can be controlled, as needed, by individual programmers. 


The last directory files in this example, JOHN.DIR and SHEILA.DIR are assigned 

to individuals: : 

e  name.DIR—each person оп the Network has a directory that can be further 
subdivided into directory files or that can be used to store status reports, memos, 
trip reports, and other miscellaneous work that is not directly related to the 
project. 


Home Directory 


A unique home directory can be assigned to each user when the Superuser defines 
the user at the МЕМ. For convenience, a SUBMIT file called ISIS.INI сап be created 
in the home directory of the user. The ISIS.INI file executes automatically at LOGON 
and assigns directory identifiers to the commonly used pathnames without user 
involvement. For details on assigning home directories, see the NDS-II Network 
Resource Manager User's Guide. 


Using the Network 


1. To access files on the Network users need: 
a. A valid username/password combination 
b. The name of the volume or directory to be accessed 
C. Access rights to the directory and data files targeted 
The Superuser of the system is the source of this information (see the NDS-II 
Network Resource Manager User's Guide). 


2. With the information listed in number one, users can log on to the Network with 
the LOGON command (see Chapter 4 of this manual). 
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To access network directory files, users must assign directory identifiers to the 
directory names. Using figure 3-1, assume you will be working in the PROJA.DIR 
and the PHASEI.DIR. 


a. The default device :Е0: is automatically assigned to drive 0. 


This assignment allows you to drop the directory prefix for commands, compi- 
lers, etc., that reside in :F0:. 


b. Assign the directory identifier :Е1: to the project directory file PROJA.DIR 
by typing 


-ASSIGN :F1: TO /WINCH1.VOL/PROJA.DIR¢cr> 

c. Assign the directory identifier :F2: to the directory PHASEI.DIR by typing 
-ASSIGN :F2: TO /MINCH1.VOL/PROJA.DIR/PHASET.DIR«cr» 
or by typing 
-ASSIGN :F2: TO :F1:PHASET.DIR«cr» 


Use the ACCESS command (see Chapter 4 of this manual) to control world 
access rights to your directory files and data files. 


Create new directory files with the CREATE command (see Chapter 4 of this 
manual). 


NOTE 


Storage capacity is the only restriction on the number of directory 
or data files the hierarchical structure will support. Any number of 
directory files can be “branched” horizontally and vertically. 
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WORKSTATION COMMANDS 


This chapter describes 

e The differences between the ISIS-III(N) and the ISIS-II operating systems 

e New ISIS-III(N) commands associated with the NDS-II Network (ACCESS, 
ASSIGN, CANCEL, CREATE, EXPORT, IMPORT, LOGON, LOGOFF, 
NETMAP, QUEUE, REMOVE, SPACE, SYSTAT, VERS, and WHO) 

e Тһе changes to the existing standalone ISIS commands (ATTRIB, COPY, 
DELETE, DIR, FORMAT, IDISK, RENAME, and SUBMIT) 


The NDS-II ISIS workstation commands operate under ISIS-III(N) software. This 
software allows workstations to operate as standalone development systems and to 
logically connect to the Network Resource Manager (NRM ) to access such network 
resources as the shared hard disk(s) and network line printer. 


The ISIS-III(N) software uses the commands and error messages described in the 
Intellec Series ПІ Microcomputer Development System Console Operating Instruc- 
tions (121608) or in the ZS7S-II User's Guide (9800306) when operating as a standa- 
lone development system. (ISIS-ILI(N) error codes are listed in Appendix А of this 
manual.) 


Differences between ISIS-III(N) and ISIS-II 
Operating Systems 


The ISIS-H and ISIS-III(N) operating systems differ in several ways. Important 
differences between the ISIS-III(N) software апа 1515-П are highlighted by shading 
in this chapter. 


File Structure 


The 1515-П file structure is based on a flat directory structure with one directory рег 
disk, as described in Chapter 2 of this manual. 


To access the file FILEB.EXT you must type :Fn:FILEB.EXT. Every directory has 
one name (:Fn:) and every file within the directory is a data file. 


Тһе NDS-II file structure is a hierarchical (or inverted tree) file structure. It can 
contain more than one directory file and many data files. See Chapters 2 and 3 for 
more information on this file structure. 


Hard Disk 


The ISIS-III(N) software does not support a hard disk or a high speed paper tape 
reader or punch attached to an ISIS workstation. However, each workstation can 
access the hard disk(s) attached to the Network Resource Manager (NRM). The 
HDCOPY and FIXMAP commands do not operate on the NDS-II NRM hard disk. 
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Flexible Disk Drives 


Flexible disk drives are assigned physical device numbers. Drives numbered 0 through 
9 are assigned at boot time according to the local physical devices available. See table 
4-3 later in this chapter for the default values. 


To access files in these drives, assign directory identifiers to the physical device names. 
Directory identifiers (:Fn:) are assigned to the local physical devices (drive | = :Fl:, 
drive 0 — :F0:). Any of these directory identifiers can be changed with the ASSIGN 
command. 


Local Printer 


A line printer attached to the local workstation remains designated as the output 
device :LP:. This printer can be used only by the workstation to which it is attached. 
No other workstation on the network can use this printer. 


Remote Printer 


The Network Line Printer attached to the NRM prints files as background jobs. 
Users can spool jobs to this remote printer with the COPY command. The DELETE 
command removes jobs from the spooler queue (:SP:). See Appendix C for a list of 
devices that are supported by ISIS-III(N). 


Accessing the NDS-Il Network 


The ISIS-III(N) software supports two new commands (LOGON AND LOGOFF) 
that allow users to access the NDS-II network hard disk(s) directories and spooler 
queue. These commands are described later in this chapter. 


Command Program Compatibility 


The VERS command identifies and displays the version number of the different ISIS 
command programs. Each command program works correctly only with the corre- 
sponding version of ISIS. 


Remote Job Execution 


Тһе NDS-II distributed job control (DJC) allows jobs to be exported on the Network 
and executed remotely at public workstations. Users can declare development systems 
as public with the IMPORT command. The EXPORT command sends jobs to queues 
at the Network Resource Manager to be executed at public workstations.To add or 
delete queuenames, use the QUEUE command. 


Job queues can be monitored with the SYSTAT command and altered with the | 


| CANCEL command. These commands are described in detail in this chapter. 
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e Command Categories 


Five command categories are described in this chapter. 
e Network Access Commands 

e Disk and Directory Maintenance Commands 

e File Maintenance Commands 

e 8080/8085 Program Execution Commands 

e Remote Execution Commands 


» 
МОТЕ 
я The command descriptions appear in alphabetical order. 
Network Access Commands 
e LOGOFF Logicaily disconnects the workstation from the Network 
LOGON Logically connects the workstation to the Network and executes 
the initialization file ISIS.INI 
Disk and Directory Maintenance Commands 
ASSIGN Assigns directory identifiers to physical devices or directories 
@ СКЕАТЕ Creates new directories in the remote network file system 
FORMAT Formats a flexible disk and copies files at the workstation 
IDISK Formats a flexible disk as a basic system or nonsystem disk at the 
workstation 
NETMAP Increases or decreases the number of available network devices 
REMOVE Removes an empty directory in the remote network file system 
Ф The [DISK and FORMAT commands cannot be used by the workstation on the hard 
disk(s) at the Network Resource Manager. 


Blank flexible disks must be formatted with either the FORMAT or IDISK command 
before they can be used on the system. The disk can be formatted as 
e A basic system disk that contains only the ISIS-III(N) files necessary to start 
>, up and operate the system workstation and to maintain the disk file directory 
(IDISK only) 
* А basic nonsystem disk that contains only the ISIS-III(N) files necessary to 
á maintain the local disk file directory, leaving more space for data than on a system 
disk 
e A system disk that contains additional ISIS-III(N) files (FORMAT only) 
If the workstation has at least two disk drives, use either the FORMAT or IDISK 


command. If the workstation has a single disk drive, use the IDISK command. 


the same density. To use that disk in a drive of a different density, format the disk 


Use a disk formatted as either a single- or double-density disk only in a disk drive of 
& again with FORMAT or IDISK in a drive of the desired density. 
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Table 4-1 shows the ISIS-III(N) files copied for each FORMAT or IDISK command 
shown. Note that the COPY command must be used in conjunction with IDISK. 


Table 4-1. Disk Formatting Example 


Type of File File Name 


ISIS-III(N) basic format files ISIS.DIR 
ISIS.MAP 
ISIS.TO 
ISIS.LAB 


«x «KKK 
хххх 


ISIS-III(N) basic system files ISIS.BIN 
ISIS.CLI 
1515.ОУ0 
ISIS.OV1 
ISIS.OV2 


ISIS-III(N) system command files 


хххх 


gii == 
ххххх 


о G (9 (0 (2 
NOTES: 
“Attributes: l= Invisible F- Format S= System W=Write-protect 


(1) Formats a basic nonsystem disk directory 

(2) Formats a basic system disk directory 

(3) Formats a system disk and copies all other files on the source disk 

(4) Formats a system disk and copies all other files that have the S attribute set 
(5) Copies any files that do not have the S attribute set 

(6) Copies all other files that have the S attribute set 


(6) 


Тһе information in table 4-1 applies only if the source directory files have the same 


file attributes set as those shown in the Attributes column. 


NOTE 


The F attribute is reserved for the basic format files and basic system files 
listed in table 4-1. Removing the F attribute from those files causes new disk 
directories to be formatted incorrectly. Assigning the F attribute to any other 


file prevents that file from being copied by the FORMAT command. 


File Maintenance Commands 


ACCESS Changes or displays the owner/world access rights of files in the 
network distributed file system 

ATTRIB Changes and/or displays the attribute(s) of local files 

COPY Copies files from one directory to another 

DELETE Removes file references from the directory and frees disk storage 


space associated with that file 
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DIR Displays the names of, and information about, the data and direc- 
e tory files listed within a directory 
RENAME Changes the names of files without changing the file's attributes 
SPACE Displays the volume information of root directory files 
VERS Displays the version numbers of command programs 
+ WHO Displays the name of the user who is logged on 


Wild Card Filenames 


The DIR, COPY, DELETE, ACCESS, and ATTRIB commands allow filenames 

that conform to the ISIS conventions to be specified using a wild card construct. 

Either of two special wild card characters can replace some or all of the characters 

in the name or extension. Wild card characters match anything when the system 
eb searches the directory for the filename. 


The two wild card characters are 
e An asterisk (*), which specifies a wild card match to any number of characters 


e А question mark (?), which specifies а wild card match 10 a single character 


Asterisks specify wild card matches to any name or extension in the directory. For 

example, 

e АВС. matches any ABC filename with any or no extension. 

e *PLM matches any filename with the extension .PLM, such as A.PLM or 
MYPROG.PLM. 


e  * ж matches all filenames in the directory. 


Asterisks can also specify wild card matches for the remainder of the name or exten- 

sion, except for the initial character. For example, 

e AB*.HEX matches any filename with AB as the first two characters of the name 
and HEX as the extension. This example would match ABC.HEX, 
ABXYZ.HEX, AB.HEX. 


e  A*B.HEX is illegal since no character except а period can follow an asterisk. 


e NOTE 


Wild card searches match only valid ISIS filenames. Directory names in the 
remote network file system that do not conform to these criteria will not be 
found in wild card searches. 


М 
8080/8085 Program Execution Commands 
. SUBMIT Enters a file that contains commands to be executed 
Remote Job Execution Commands 
CANCEL Cancels a queued job that is executing or waiting to execute 
EXPORT Sends a user-specified job to a queue for remote execution 
e IMPORT Creates public workstations to service user-defined job а) 
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QUEUE Creates or deletes remote job queues 
SYSTAT Lists jobs waiting in remote job queues 


Тһе NDS-II Network Resource Manager controls the remote job execution on the 
network. It recognizes public and private workstations and maintains all status infor- 
mation about remote jobs and the workstations. 


NDS-II provides distributed job control that allows user-created jobs to be executed 
at public workstations. Commands are also available to monitor and to cancel jobs 
queued for execution. 


Private and Public Workstations 


The NDS-II МКМ recognizes two types of workstations: private and public. When a 
workstation is first powered up, it is a private workstation. Private workstations operate 
as a normal network development system. In addition to executing their own jobs, 
private workstations can send jobs to the NRM for execution by public workstations 
in the Network. 


Public workstations are development systems that accept jobs from the NRM for 
remote execution. Development systems operating as private workstations can be 
turned into public workstations with the IMPORT command. To restore a public 
workstation to a private workstation, press Control-C at the keyboard. 


Creating and Naming Queues 


When a private workstation is turned into a public workstation with the IMPORT 
command, the user must specify which queues the workstation will service. If the 
specified queue does not exist, a new queue is created; otherwise, the public worksta- 
tion is added to the list of servers for the specified queue. 


Network job queues provide a way to match the type of job with the type of worksta- 
tion necessary to execute the job. The NRM does not have predefined job queues. 
The QUEUE command creates job queues. This flexibility allows a customized match 
of queue names and the workstations serving the queues. 


Because the NDS-II network may contain different types of workstations (Series ІП, 
Series II, or Model 800), it may be necessary to determine which workstation should 
get what types of jobs. A properly designed queue naming convention is necessary to 
help ensure that only a workstation with the correct hardware will execute a job. For 
example, use SERIESII as the queue name for 8085 programs and SERIESIII as 
the queue name for 8086 programs. 


Тһе МКМ sends jobs from the queues to public workstations as the workstations 
become available. It is not possible to indicate which workstation of those serving a 
particular queue will execute a remote job. For example, if an 8086 program is 
mistakenly sent to a job queue served by a Series III workstation and a Model 800 
workstation, the job may be sent to the Model 800 workstation to execute. Because a 
Model 800 workstation does not have an 8086 processor to execute the job, a fatal 
error will occur and the job will be aborted. 
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Program Control and Code Conversion Commands 


The following manuals describe the program control commands (for Librarian, Linker, 

and Locator) and code conversion commands (for hexadecimal to/from object module 

format conversion): 

e  MCS-80/85 Utilities User's Guide for 8080/8085-Based Development Systems 
(121617) 

e ТАРХ 86,88 Family Utilities User's Guide for 8086-Based Development Systems 
(121616) 


Entering Commands 


Enter commands to the NDS-II network and ISIS-III(N) at the workstation as 
follows. First, turn on the workstation and disk drives; then, insert the NDS-II 
workstation system disk into disk drive 0; and, finally, press RESET. ISIS-III(N) 
will sign on and issue its prompt character (a hyphen): 


ISIS-IIICND) Уху 


where 


Xy is the version of ISIS-III(N). 


Users can enter commands whenever the ISIS-III(N) prompt is displayed. Each 
command is entered as a command line and must be terminated by a carriage return 
or a line feed. Pressing the RETURN key after entering a command line automati- 
cally enters a line feed. 
Command Syntax 


The general syntax of an ISIS-III(N) console command is 


command parameters < cr > 


where 
command is the name of the program. 
parameters are one or more items required by the command. When 


entering more than one parameter, separate them with 
commas or blank spaces unless otherwise noted under the 
individual commands. When a parameter consists of switches, 
separate them by spaces, not by commas. 


In most cases, a command executes when the carriage return is encountered. Any 
exceptions are noted under the individual commands. 


NOTE 


Some of the ISIS-III(N) commands have the same name and a similar 
function as the iNDX operating system commands that run on the NDS-II 
Network Resource Manager. However, the syntax of the commands is 
different. You must use the correct command syntax for the corresponding 
operating system. 
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Specifying Files 
The command syntax of many commands includes the following designation: 
: Fn: filename 


Where this format is shown, the following definitions apply unless otherwise noted 
under the individual command: 


Еп is the directory identifier of the directory or device that contains filename. The 
value n is an integer between О and 9 inclusive. If :Fn: is not specified, :Е0: is assumed. 


filename is the name (and extension, if any) of the target file. Enter filename immedi- 
ately after :Fn: with no intervening space, as in :FI:MYPROG. 
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ACCESS 


Syntax 
noorse | БЕ filename 1 ву/йСһ1<сг» 
pathname / 
where 
:Fn: is the directory identifier that contains filename. The value n 
is an integer between 0 and 9 inclusive. If :Fn: is not speci- 
fied, :F0: is assumed. 
pathname is a fully qualified pathname to the filename's directory. 
filename is the name and extension, if any, of the shared file. 
switch specifies the owner access rights of filename. See table 4-2. 
Description 


The ACCESS command lists or changes the access rights of the file’s owner or other 
users to a shared data or directory file. Access rights can be used to protect files from 
accidental change or deletion. 


Listing Current Access Rights. To list the current access rights of a shared file, type 


FILENAME OWNER LENGTH ТҮРЕ OWNER ACCESS WORLD ACCESS 
WORKFL.NEW MARK 3128 DATA DARN R 


Changing Access Rights. To change the access rights of data files or directory files, 
use the ACCESS command switches. The 24 switches consist of 3 characters typed 
with no intervening space. 


The first character indicates the owner rights to be controlled —the file owner (owner) 
or the other network users (world). 


The second character indicates the type of access to be controlled. Files have three 
access rights: read, write, and delete. Directories also have three access rights: list, 
add-entry, and delete. 


Table 4-2. Network File Access Rights 


OWNER O — Owner of the file or directory 
W — World or public users 


ACCESS Data files: 

R — Read a file 

W — Write a file 
D — Delete a file 


Directory files: 
L — List a directory 
A — Add a directory entry 
D — Delete a directory 


0 — Deny access right (reset, off) 
1 — Grant access right (set, on) 


RIGHT 
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The third character indicates the specified access right as reset (off) or set (on). A 
zero (0) indicates the switch is off, and the access right is not granted. A one (1) 
indicates the switch is on, and the access right is granted. 


After the access rights of files or directories are changed, the new access rights are 
displayed. 


To allow the world to read a file, set the world read switch ON: 


NOTE 


Files that have world write access set can be altered by any network user. 
Files that have world delete access ѕсі can be deleted by any network user, 
even if he does not have write access to the files. 


Altering Access Rights of Multiple Files and Directories. The access rights of more 
than one shared file or directory can be changed simultaneously. However, the access 
rights of the files must be changed to a common switch. To "turn off" the owner 
delete rights to files FILEI.EXT, FILE2.EXT, and FILE3.EXT, type 


Superuser Access Rights. Every network file has access rights assigned to the 
Superuser. These switches can only be manipulated by the Superuser at the NRM. 


Possible Error Conditions 


An error occurs when 
e You are not logged on 
e You try to access files or directories that do not exist 


e You do not have the access rights to change the access characteristics of a file or 
a directory 


Notes 


1. Use the ACCESS command with shared files only. 


Examples 


1. This example "turns off" the world add access rights of the shared е, 
NEWFIL.EXT. 


MACCESS NEHFIL.EXT. MA0«cr» 


2. This example "turns on" the owner read and write access rights of any file that | 
matches in an ISIS wild-card search for DAT *.*. 


MACCESS DAT*.* 081 OWlecr> 


NDS-II ISIS-III(N) 


NDS-II ISIS-HI(N) 


83 


Workstation Commands 


This example lists the current access rights of the shared file ACC.DIR. 


MACCESS ACC.DIR. «ond 


FILENAME 
ACC.DIR 


OWNER 
JEANNE 


LENGTH 
10904 


ШИРЕ 
DATA 


ÜHNER ACCESS 


D 


W 


WORLD ACCESS 
H 
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ASSIGN 


Syntax 


ASSIGN ien) [TO y] 
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where 

:Fn: or n is the directory identifier that is a logical device. 

n can be any number 0—9. The directory identifier for the 
default system drive is :F0:. The directory :F0: must contain 
the files ISIS.CLI, ISIS.BIN, ISIS.OVO, ISIS.OVI, and 
ISIS.OV2. 

y is one of the following: 

A physical device name (drive 0—9) 
A network directory pathname (/WINCHI.VOL/ 
PROJA.DIR/ TEST.DIR) 
Another directory identifier (:F0: - :F9:) 
A directory identifier and a pathname component 
CF0:MYDIR) 
The word NULL 
Description 


The ASSIGN command allows a directory identifier to be mapped into the NDS-II 
hierarchical file system. ASSIGN provides access to the shared network files with 
ISIS file-naming conventions. This command lists current assignments and assigns 
logical device names (:F0:—F9:) to a physical device name, a network directory 
pathname, or another directory identifier. 


Startup. Atinitial system bootstrap, when the RESET button is pressed, the directory 
identifiers of the physical devices (disk drives) are set to the default values listed in table 
4-3. These assigned directory identifiers can be changed with the ASSIGN command. 


Table 4-3. ISIS-III(N) Supported Configurations 


Default Drive Numbers 


D 
S 
N 
D 
D 
S 
N 
D 


zzgogoozzz 
22220222 
2222222 


Double density flexible disk 

Single density flexible disk 

Integrated single density flexible disk 
Integrated double density flexible disk 
Not available 


Parentheses ( ) indicate optional drives within the particular configuration. 


2222222 


22222222 
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Network devices that are represented in table 4-3 with N for NULL are not automat- 
ically assigned directory identifiers. :F9: is an exception; it is automatically assigned 
to the user's home directory. To access network directories, assign them directory 
identifiers with the ASSIGN command. 


Listing Current Assignments. To list the current assignments of directory identifiers 
to disk drives, type 


- SN 


This command generates a listing of all directory identifiers and their current 


assignments. 

DEVICE ASSIGNED TO 
ЕО: DRIVE 0 
Е DRIVE 1 
PEBE DRIVE 2 
ЖЕЗ DRIVE 3 
ЖЕЕ: DRIVE 4 
Spa DREVES 
ARGE NULL 
Б NULL 
ӘЛЕ САН NULL 
s Әсе JWINCH1.VOL/JOHN.DIR 


NOTE 
If the user has been assigned a home directory, :F9: is assigned initially to 
the user's home directory (e.g., /WINCHI.VOL/JOHN.DIR) at LOGON 
time. 


Changing Directory Identifier. To change directory identifier assignments, use the 
ASSIGN command and follow the syntax conventions listed above. For example, to 
change the directory identifier assignment of :FO: to the flexible disk drive 2, type 


Е ОТСОН USE RIA ERAS SIND 
BASSIGN oF 020.10 Г 
This allows access to the ISIS command programs and other files on the disk without 
typing a prefix. Any command with :Е0:, or no directory identifier, will go to physical 
device 2 (disk in drive 2) for the filename. 


NOTE 
Default directory :Е0: must contain the ISIS system files and any other 
command file to be invoked from the default directory, :F0: (e.g., COPY, 


DIR, ASSIGN, etc.). Physical device drive 0 must have at least the basic 
format files and the file ISIS.BIN. 


Assigning Network Pathnames and Directories. Directory identifiers can be assigned 
to network directory pathnames. This allows access to remote files maintained in the 
remote, network directories. 


To access the remote file CHAP2.TXT in the MYBOOK.DIR directory in figure 
4-1, assign :F1: to MYBOOK.DIR by typing 


LOGON USERA PASSUD«cr» 
BASSIGN 1 TO /PROJA.VOL/MYBOOK.DIR«cr» 


You can now access the file CHAP2.TXT using the pathname :F]:CHAP2.TXT. 
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LOGICAL 
SYSTEM 
ROOT 


PROJA.VOL 


MYBOOK.DIR 


CHAP2.TXT 


CHAP1.TXT FILE4.EXT 


| FILE2.EXT а FILES.EXT ] 
ee ee eae | 


Figure 4-1. Sample Network Fire Structure 121765-5 


Available Network Directories. Тһе number of available network directories acces- 
sible by default from a workstation depends on the workstation's hardware configu- 
ration (see table 4-3). A NULL entry in table 4-3 represents one available network 
directory. For example, when reading across the table, the first configuration listed 
(one double-density disk drive) has six NULL entries. Thus, up to six network direc- 
tories can be assigned with this hardware configuration. | 


Use the МЕТМАР command to increase the number of available network devices, 
and to decrease the number of available local devices. 


NOTE 
Basic ISIS system files must be present on the default system disk, physical 
drive 0 


ASSIGN will affect the disk maintenance commands such as IDISK and 
FORMAT. 


Notes $ 


1. Hardware RESET and LOGOFF reassign the directory identifiers to the default 


values. (See table 4-3.) > 
2. Interrupt 1 will not affect directory identifier assignments. 
3. ASSIGN displays fully qualified pathnames of the files when directory identi- 


fiers are assigned to network directory files. 

4. The NETMAP command can alter and then restore the system's default device 
configuration. See the NETMAP command. 

5. МЕТМАР can affect directory identifiers. When NETMAP removes assigned 
devices, the corresponding directory identifiers are reassigned. These reassigned 
directory identifiers are assigned to the NULL device. 
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Examples 


l. 


In the following example, directory identifier :Е0: is assigned to physical drive 3. 


ТІП: їс 5 


ШАО СОКОН ЖЕШ: 


This example lists the assignments for a network in which the directory identifier 
:F0: has been reassigned from drive 0 to drive 3. Now :F0: and :F3: both refer- 
ence files on drive 3. The user's home directory is automatically assigned to :F9: 


DEVICE ASSIGNED TO 
FO: DRIVE 3 
SEIN DRIVE 1 
ЕО: DRIVE 2 
SEIS DRIVE 3 
F4: DRIVE 4 
eir 35 DRIVE 5 
:Е6: NULL 
ЕРТ NULL 
Biz tig NULL 
Ж 9 /WINCH1.VO0L/JOHN.DIR 


Th's example assigns the directory identifier :Fl: to the network directory 
pathname /PROJA.VOL/M Y BOOK.DIR in figure 4-1. 


ІСТІ ЛЕВООА? МҮК DIR ec 


“DEVICE ASSIGNED TO 


8000 DRIVE 3 

САКАТ: /PROJA.VOL/MYBOQK.DIR 
ЖЕ 2: DRIVE 2 

ЕЗ: DRIVE 3 

647: DRIVE 4 

Br SE DRIVE 3 

F6: NULL 

ef 78 NULL 

:F8; NULL 

597 /|MINCH1.VOL/JOHN.DIR 


To assign a directory identifier to the directory CHAPI.DIR within the 
MYBOOK.DIR directory file, type 


BASSTGN :EF7: to /PROÜOJA.VOL/MYBOOUK.DIR/CHAP1.DIR«(cr) 


or 


BASSION :F7: TU :Ғ1: СНАРТ, рів сг» 
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5. In this example, the directory identifier :Е0; is assigned to the physical disk 

drive 1. 

BASSIGN :F0: TOU teer> 

WASS EGN r? 

DEVICE ASSIGNED TO 

ESIET DRIVE 1 
ШЕР: /|PRÜJA.VOL/MYBOOK. DIR 
SES DRIVE 2 
a [58 DRIVE 3 m 
:F 4: DRIVE 4 
gio DRIVE 5 
SEDIS NULL $ 
ҒЫР ТАБ NULL 
Р): NULL 
КӨ? NULL 


6. This example shows an attempt to assign a directory identifier to a directory that 
has more than 14 characters. 


CHAPTERTHENTYSEVEN, LEGPGAL FILE NAME 


7. This example shows an unsuccessful attempt to assign the unassigned directory 
identifier :F4: to the sixth network directory, /PROJA. VOL/MY BOOK.DIR/ 
ROB.DIR. This assignment is unsuccessful because the current device configu- 
ration of the workstation only supports five network devices. 


ALL КЕПШЕ (— m "USE 


DEVICE ASSIGNED TO 

gia DRIVE 0 

BUB DRIVE 1 

BARB DRIVE 2 

SEIS DRIVE 3 

F4: DRIVE 4 

ХЕЧ: /PROJ.B 

:Е6: /PROJ.B/JBOOK.DIR 
BITES /PROJ.C/ELLEN.DIR 
:Ғ8: /PROJA.VOL/MYBOOK.DIR 
8278 /WINCH1.V0L/JOHN.DIR 
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ATTRIB 


Syntax 


ATTRIB [:Fn:] filename Lattriblist) 19) ‹сг» 


where 
Еп: is the directory identifier of the directory where the local file 
resides. 
filename is a local file whose attributes are to be changed. The wild 
card construction can be used to change or display the attri- 
butes of a group of files. 
attriblist is one or more of the following: 


IO or Il resets (10) or sets (11) the invisible attribute. 
When set, the local file is not listed by the DIR 
command unless the I switch is specified in the 
DIR command. 


WO or WI resets (WO) or sets (W1) the write-protect 
attribute of a local or network file. When set, 
the file cannot be opened for output or update, 
and cannot be deleted or renamed. 


FO or FI resets (FO) or sets (F1) the format attribute. 
Removal of the format attribute from local files 
will cause improper formatting of new system 
disk directories. This attribute is reserved for 
specific system files and should not be assigned 
to any other file. Assigning this attribute to any 
other file will cause that file not to be copied by 
the FORMAT command. 

SO or SI resets (SO) or sets (SI) the system attribute. 
When set, the local file is copied to the disk being 
formatted by the FORMAT command when the 
S switch is used. This file is also copied by the 
COPY command when the S switch and wild 
card notation are used. 


Q specifies query mode operation. 


If two values of the same attribute are specified, for example both 10 and 11, the one 
rightmost in the command takes precedence. 


Description 
The ATTRIB command changes or displays the specified attributes of local files. 


When you specify the Q switch, ATTRIB displays the following message before 
changing the attributes of the file: 


filename, MODIFY ATTRIBUTES? 


Type a Y or y to modify the file’s attributes. Any other response causes ATTRIB to 
leave the attributes unchanged for the specified file and to go on to the next file in 
the group. When attributes for a file have been changed, the current attributes for 
the file are displayed. 
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If a nonexistent disk file is specified, ATTRIB displays 
filename, NO SUCH FILE 
If a nondisk file is specified, ATTRIB displays 


filename, NON-DISK DEVICE 


Possible Error Conditions 


An error occurs when 

e Тһе file does not exist 

e Тһе directories are not assigned 

e You do not have proper access rights 


Notes 


1. Use the ATTRIB command only on local files. 


Examples 


l. This example changes the write-protect attribute of a group of files. 


- (25) 
FILE CURRENT ATTRIBUTES 
: ЕО: PROGA,SRC W 
: ҒО: PROGA.0BJ W 


N 


This example sets the system attribute for the TYPE program so the file will be 
transferred onto new system disks (see FORMAT command). 


MATTRIB TYPE S1«cr» 


FILE CURRENT ATTRIBUTES 
:FO:TYPE 5 
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e CANCEL 


Syntax 
CANCEL Cjobname) ed 
queuename | €s jobnumber) есет 
where 
ә queuename is the location where the job was sent to await remote 
execution. 
jobname is the filename of the job sent to the queue. 
. ү : ; s 
jobnumber follows the # sign and is the hexadecimal number assigned 
by the system when the job is sent to the queue. 
Description 
Ф Use the CANCEL command to cancel remote jobs. Queued jobs that are waiting ог 
executing can be canceled. Any number of jobs can be canceled at any one time. 
Use the SYSTAT command to find the job name and number of specific jobs in 
queues. 
NOTE 
The CANCEL command cannot be used from an imported job that is 
executing. Àn error message appears. 
© Possible Error Conditions 
An error will occur when 
e You are not logged on 
e The job name does not exist 
e Тһе job number does not exist 
e You attempt to cancel a job you did not export 
e e You attempt to cancel a job that belongs to another user 


Examples 
1. This example cancels the job COMPLE.CSD in the queue SIIJOBS. 


BCANCEL SIIJOBS CCOMPLE.CSD)<cr> 


N 


This example cancels three jobs in two different queues. 


% EMCANCEL SIIIJOBS (COMPLE.CSD, #34), SIIJOBS (MYPROG.CSDO«cr» 
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COPY 


Syntax 


m [:Fn:1toutfilel : 
CORY TIvEnY dnfle Dy TO ық Lswitches] «cr» 


where 
е 
:Fn: refers to the directory identifier of the directory where the 
file resides. 
infile is the file (or group of files when using the wild card » 
construct) to be copied. The copy does not affect the contents 
of infile. If more than one іл е is specified, they are conca- 
tenated in the order specified. When concatenating files, 
specify the full name and extension of each file; do not use 
the wild card construct. infile can also be :Cl:. 
outfile is the file to be created or recreated. If :Fn: is not specified, 
:F0: is assumed. outfile must include the extension, if any. If 
outfile is not specified, :Fn: must be specified. 
:device: is an output device, such as :LP:, :TO:, :SP:, or :CO:. 
switches are one or more of the following: 


S copies only local files with the system attribute set. For 
example, the command 


copies only files with the system attribute from drive 0 
to drive 1. Valid for local directories only. 


N copies local files without the system or format attribute 
set. Valid for local directories only. 


P specifies single flexible disk drive mode. When files are 
to be copied between two flexible disks on the same 
drive, the system prompts for disk swaps with the 
following messages: 


LOAD SOURCE DISK, THEN TYPE (CR) 
LOAD OUTPUT DISK, THEN ТҮРЕ (CR) 
LOAD SYSTEM DISK, THEN TYPE (CR) 


Valid for local directories only. 


Q specifies the query mode. The system displays the ^ 
following message before the copy is performed: COPY 
infile TO outfile?. A yes or y response causes the copy 
to be performed. Any other response causes the copy 
not to be performed. 


C creates outfile with the same attributes as the infile. For 
example, if file XYZ with the I attribute set is copied 
to the file ABC, the final file ABC will have the I 
attribute set. Valid for local directories only. 


If this switch is not specified, outfile is created with all 
attributes reset (off). This switch does not copy the 
format (F) or owner (O) attributes. Valid for local 
directories only. 
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B  deletes an existing file without displaying the 
ALREADY EXISTS prompt. The existing file is 
deleted and recreated with new data. Valid for network 
and local directories. 


U opens outfile for update instead of deletion. The 
ALREADY EXISTS message is suppressed. The length 
is not changed unless the copy causes an increase in the 
size of the file. Valid for local and network 
directories. 


If U and B are both specified, the U function is 
performed. 


Description 
The COPY command copies files from one directory to another. 


When copying from one directory to another, the destination can be directory files or 
physical devices. The copy must be made from an input device to an output device. 
For example, you can copy from the console to the printer but not from the printer 
to the console. 


If outfile is an existing disk file and is not write-protected, the following message is 
displayed: 


outfle FILE ALREADY EXISTS 
DELETE? 


A yes or y response (followed by a carriage return) causes COPY to delete the exist- 
ing file before making the copy. No change is made for any other response. 


If outfile is write-protected, then the following message is displayed: 
outfle WRITE PROTECTED 


Single Drive Mode. The COPY command supports single flexible disk drive systems. 
You can copy files from one flexible disk directory to another using only a single 
drive. The command prompts for the source, output, and system disks as it needs 
them. If you specify a copy on a drive with no change in filename, the command 
assumes you want to swap disks and prompts for the swaps. For example, the command 


McoPY ABC TO АВС: «сг» 

results in prompts to swap disks in drive 0. But the commands 
COPY. ABC TO :F1:ABC«cr» 

and 


SCOPY ABC TU DEF«cr» 


do not result in prompts for disk swapping. You can also copy local files between 
different disks on the same drive by specifying the P (pause) switch in the command. 
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Wild Card Designations. When you use wild card designations, the following rules 

apply: 

e Every position in the infile name that contains an asterisk must have a corre- 
sponding asterisk in the outfile name. 


e — Every position in the infile name that contains a question mark must have a corre- 
sponding question mark or asterisk in the outfile name. 


“ Тһе wild card characters cannot be used in directory designations (you cannot 
specify :F*:). 


To copy files selectively with the wild card construct, use the query mode. For example, 


The system will display the query message before copying each file. 


Copying to Another Directory. The COPY command provides a special case for 
convenience when copying directory files to a different directory. If outfile is to have 
the same name as infile, a specific outfile is unnecessary. For example, 


A1 the end of the listing of files that were copied, the following message is displayed 
if write-protected files have been encountered. 


WRITE PROTECTED FILE ENCOUNTERED 
The write-protected files are not copied. 


Using a wild-card designation when concatenating files causes an error message to 
be displayed. 


MCOPY A, BC. TO D«cr» 


WILD CARD DELIMITERS DURING CONCATENATE 


When you use the concatenate operation, outfile must not have the same name as 
infile. If it does, the following error message results: 


ЫСОРҮ А, B TO B«cr» 
SQURCE FILE EQUALS OUTPUT FILE ERROR 


If the rules governing wild-card designations are not followed, the following error 
message is displayed. 


ЫСОРҮ ABC. TO D«cr» 


FILE MASK ERROR 
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Possible Error Conditions 


An error occurs when 


e Тһе source file is not present 


• The destination file already exists 


e Тһе destination file is write- 


protected 


a You do not have access rights to the source file 


e You do not have access rights to the destination file 


Examples 


|l. This example copies three files to one, overwriting its contents. 


ә 


APPENDED :F0:CHAP 
APPENDED :F0:CHAP 
APPENDED :F0:CHAP 


3. This example lists a file on the local (workstation) line printer. 


COPY BOOK. TO сыр: 


COPIED :F0:BOOK T 


4. This example copies a file from directory 0 to directory 1. 


:BOOK FILE ALR 
BL Т) 
APPENDED :F0:CHAP 
APPENDED :F0:CHAP 
APPENDED :Ғ0:СНАР 


DY EXISTS, 


1 TO :F0:BOOK 
2: TO БО ЕВ 
S. STU AFOB: OUK 


See 
1 TO :F0:BOOK 
2 ТО :F0:BOOK 
3 ТО :Ғ0:В00К 


Corn > 
ПЕШЕР: 


ЫСОРУ-РРОА TO :FIENEWPRG Beer» 


COPIED :F0:PROGA 


TO :Fi:NEWPRG 
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Example | could have been done in the following way using the update switch: 


5. This example copies system files from one disk directory to another in disk 


directory 0. 


ЫСОРҮ *.* TO 

LOAD SOURCE DISK, 
LOAD OUTPUT DISK, 
COPIED :Ғ0:А5М80 


LOAD SYSTEM DISK, 


Secr» 

THEN TYPE (CR) 
THEN TYPE (CR) 
TO :Ғ0:А5М80 


THEN TYPE (CR) 
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6. 


If the files to be copied are quite large (exceeding the size of the available RAM), 
the LOAD SOURCE and LOAD OUTPUT messages will be displayed more 
than once. As each file is copied, а COPIED message is displayed. After the last 
file is copied, the LOAD SYSTEM message is displayed. 


These examples show valid uses of wild-card names with the COPY command. 


(copy all files except those with 
the FORMAT attribute) 


(copy all nonsystem and non- 
format files) 


This example shows a valid use of the COPY command concatenating files on 
the remote directory REMTE.3. 


ШР ҮЕ ЕШТЕ ШЕ ГЕН ТӨСТІК 
AIPP/ENIDEIDE EO ЕЕМТЕ 4 TO, Ее КЕМТЕ ТЗ 
APPENDED MMP GsREM TE. 2 TO OARE MTER S 


S 


This example copies the file :F1:BOOK to the network spooled printer queue. 


ЕЕВС 


This example copies the file :F3:MYFILE.TXT to the network spooled printer 
queue. 


BCOPY СЕЗ MYETUECDXT TO SSP Ос гу 
CRA OnE WES Sr СО РЕ ЮТ OI: GT: 
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CREATE 


Syntax 
: Ел: 2 
CREATE pathname / new directory пате< ст» 
where 
pathname is an existing directory. 
ЕЛ: is the directory identifier assigned to the physical device 


or the directory in which the new directory will reside. 


new directory name is a string of up to 14 alphanumeric characters. 


Description 


The CREATE command creates new directories in the remote network file system. 
Users can specify the fully qualified pathname or the pathname component prefixed 
by the directory identifier when specifying new directories. 


All components in the pathname must point to existing directories, except the new 
directory name. The new directory name is the only component that specifies a non- 
existent directory. 


When directory pathnames are prefixed by the directory identifier (:Fn:), the name 
must be assigned to a valid directory path. 


The user is automatically granted all owner access rights to new directories. Access 
rights for new directories are 


e Delete access 
e List access 


e  Add-entry access 


Access rights can be changed with the ACCESS command. 


Possible Error Conditions 


An error will occur when 

e You are not logged on 

e You do not have access rights to create a directory 
e The parent directory does not exist 

e Тһе new directory name already exists 


e The new directory name exceeds 14 characters 


Notes 


1. Usethe REMOVE command to eliminate an empty directory. 


2. Directory names that contain an asterisk (*) Сап be used. However, single quotes 
C) must enclose the entire character string when accessing the file. Single quotes 
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literalize characters that are not normally usable in the ISIS environment: COPY 
'/WINCHI/PROJ*A/FILEP to :F2:MYFILE <cr>. 


Examples 


|. This example creates the directory SRCS in the /VOL/NRMI/COMPILERS 
directory. | 


-[ ХШ ДШИ: 


ИСО РТ РББ ОВО 51 сг > 


гә 


The directory identifier :F5: is assigned to the directory /VOL/NRM1/COMPI- 
LER. The directory SRCS is then added to this parent directory. 
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e DELETE 


Syntax 


DELETE Г:Еп: 1 filename [switches] «cr» 


where 
Ы Еп: refers to the directory identifier of the directory where the 
file resides. 
filename is the name of the file to be deleted. The wild-card construc- 
S tion can be used to delete group of private files. 
switches are one or more of the following, separated by spaces: 
Q specifies the query mode. The system displays the 
following message before each file is deleted: filename, 
DELETE?. A yes or y response causes the deletion. 
Any other response causes the deletion not to be 
performed. Valid for network and local files. 
P specifies single drive mode. The system displays prompt 
messages for disk swaps. Valid for local files only. 
Description 


The DELETE command deletes private directory entries. Shared directory entries 
e can be deleted if the world access delete switch is set. 


This command effectively removes the specified file, directory, or group of files from 
the directory, making the space it occupied available for reassignment. Files with the 
write-protect or format attribute set cannot be deleted. 


If filename is a file with neither the write-protect nor format attribute set, the file is 
deleted and a confirming message is sent to the console. 


If filename does not exist, the following message is sent to the console: 


e filename, NO SUCH FILE 


If the file cannot be deleted because filename has the write-protect or format attri- 
butes set, the following message is sent to the console: 


filename, WRITE PROTECTED 


х | МОТЕ 
All directory entries must be deleted before the directory can be deleted. 


t Query Mode. Using the Q switch displays the query message before deleting each 
file. 
The query mode allows you to delete files selectively when using the wild-card 
construct. For example, 
MDELETE :Fn:CHAP?.* G«cr» 
e The system will display the query message for each file that matches the wild-card 
construct. 
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Single Drive Mode. For single-density disk drive workstations, specify the P (pause) 
switch with the command. Before performing the deletion, the system displays 


LOAD SOURCE DISK, THEN ТҮРЕ CCR) 
Upon completing the deletion, the system displays the following message: 


:Fnifilename, DELETED 
LOAD SYSTEM DISK, THEN TYPE (CR) 


Examples 
1. This example uses the wild-card construct to delete three files. * 
PDEU ETEN КИЯ 


БЕНСОН Р ЛАТ. DELETED 
HREOC HAP 2ST; DELETED 
SE фас РР ORC. DELETED 


һә 


This example shows an attempt to delete the file PROGA.ASM with no delete 
access rights. 


2 Sial Cini») 
TFOSPROGH ASM, WRITE PROTECTED 


3. This example shows the deletion of the file PROGB.ASM using the P switch. 


SDE WET ES ГЕО С В ASM PCT 
ЗІ): SOURCE DISK; THEN: TYPE (CR) 
Әр иер ОН A/S, DELETED 

ЕЗІ; SVETEM DESK THEN ТҮРЕ COR) 


4. This example deletes the file :SP:BOOK from the spooled print queue. 


BDELETE.:SP:BOOK<¢cr> 
:5Р:В00К, DELETED 


л 


This example deletes the file :F2:PROJ.ASM using the query switch. 


BMDELETE :F2:PROJ.ASM G«cr» 
Е 2: РВОЈ. АЅМ, DELETE? 


mmm . 


:F2:PROJ. ASM, DELETED 
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DIR 


Syntax 


FOR filename 


DIR / 


where 


filename 


/ 


listfile 


switches 
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(TO /istfileY switches] «cr» 


is the file (or group of files specified with the wild-card 
construction) whose directory entry is to be listed. If FOR 
filename is omitted, the entire directory is listed. If filename 
is not a wild-card name (that is, does not contain an asterisk 
or a question mark), it is listed even if it has the invisible 
attribute. 


will print all volume root directories that are available. 


is the name of the file or output device such as :TO:, :LP:, or 
:F2:LIST.FIL, where the directory listing will be displayed. 
If TO iistfile is omitted, the listing is displayed on the screen. 


are one or more of the following, separated by spaces: 


0-9 lists the directory. If omitted, the directory of the disk 
in drive 0 is listed. If more than one directory number 
is specified, only the rightmost one has effect. The 
directory number also overrides any device specifica- 
tion in FOR filename. 


E lists the extended directory for remote network direc- 
tories including: filename, number of bytes in the file, 
the owner's name, file type (directory or data), owner 
access rights, and world access rights. Valid for remote 
network directories only. 


SP lists the contents of the network spooler print queue. 
Valid for network directories only. 


I lists all files, including files with the invisible attribute 
set. If omitted, only files with the invisible attribute 
not set are listed. 


F gives brief output, listing only filenames. For remote 
network directory files, this is the default value. 


О prints the local file directory in a single column format. 
The default is a double column format for local direc- 
tory files, and a triple column format for remote 
network directories. 


Z prints the number of sectors presently used on the 
specified local workstation disk directory as a fraction 
of the number of available sectors. 


P specifies single drive mode at the workstation. After 
loading the command, the system pauses with the 
message 


LOAD SOURCE DISK, TYPE (СЕ) 
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After the source disk is loaded in the workstation drive 
and the RETURN key is pressed, the requested direc- 
tory is output to the specified device. The system then 
requests that the system disk be replaced: 


LOAD SYSTEM DISK, TYPE (CR) 
‘Valid for local directories only. 


The above ordering of the fields (e.g., [FOR filename], (ТО listfile], [switches]) for 
the DIR command is not fixed. 


Description » 


The DIR command lists the contents of directories. For network directories, DIR lists 
all remote files. 


NOTE 
Wild-card searches match only valid ISIS filenames. Names of remote 


network directories that do not conform to these criteria will not be found in 
a wild-card search. 


Local Directory. Two-column output with the following headings is the default for 
local directories: 


DIRECTORY OF name.ext 


NAME .EXT BLKS LENGTH ATTR NAME .EXT BLKS LENGTH 
ATTR 


XXXX BLOCKS USED 


where 


name.ext is the label of the disk directory that is assigned by the 
FORMAT or IDISK command. It has the same syntax as a 
filename. Each item listed by DIR is explained in the Znrellec 
Series III Microcomputer Development System Console 
Operating Instructions. This directory listing shows the 
number of blocks (xxxx) available on the disk. 


Network Directory 


:Fn: REMOTE DIRECTORY 
FILENAME OWNER LENGTH TYPE OWNER ACCESS WORLD ACCESS 


where 


FILENAME lists the names of all data and directory files that reside in 
this directory. * 


OWNER is 
username—the username of the file owner 
SYSTEM —operating system and command files 
SUPERUSER—files that belong to the Superuser 


NOT FOUND-—files assigned users whose usernames have | 
been deleted from the system 


is the number of bytes the file takes up in the disk. | 


LENGTH 
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TYPE identifies files as data or directory files. 
OWNER ACCESS lists the access rights of the file owner. 


WORLD ACCESS lists the access rights for other network users set by the 
file owner. 


Examples 


l. 


t2 


This example lists the two files PROGA and SUMS from a flexible disk direc- 
tory on a single-density workstation system. The system files, which have the 
invisible attribute set, are not listed. 


DIRECTORY OF :F0:1800AB.SYS 


NAME WENT BLKS LENGTH ATTR NAME EXT BLKS LENGTH ATTR 
PROGA .HEX 75 9263 H SUMS 51 6357 
126 


936/2002 BLOCKS USED 


This example requests a fast listing of the listing in example 1. 


DIRECTORY OF :F0:1ISODAB.SYS 
PROGA.HEX SUMS 
936/2002 BLOCKS USED 


The following example requests that a directory listing of all the workstation’s 
format files be sent to the local (workstation) line printer. The I switch must be 
specified because the format files have the invisible attribute, and ISIS.* is a 
wild-card filename. 


- I ГЕР Өс» 


EOR-ISIS:: 


10 


The following example requests a single-column fast directory listing of the „ 
double-density flexible disk in drive 1. 


Bie 1 F Overy 

DIRECTORY OF DISK :Fi:ISI.V10 
TYPE.M80 

ТЕРЕ: Н:ЕЕХ 

ТҮРЕ 

1337/4004 BLOCKS USED ` 


This example lists the extended directory for a network directory. 


Diro Ecer 

:F0: REMOTE DIRECTORY 

FILE NAME OWNER LENGTH TYPE OWNER ACCESS WORLD ACCESS | 
MEMOS.DIR SANDI 10904 DIR DLA DLA | 
MYPRUG.SRC RITA 7299 DATA DR R 
WORKFL.NEW JEANNE 8063 DATA R MW R 
SYSTEM.LIB SUPERUSER 3128 DATA DRM R | 
A USERI 7299 DIR DLA DLA 
ACC.DIR JEANNE 10904 DATA D W W 

PROG.X12 DENNIS 10054 DATA DRM R 

FMHP.CSD AMY 210 DATA DR R 


AEDIT SUPERUSER 27467 DATA R DRM 
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This example displays the directory listing of the spooler printer queue. 


Pk sP cerol 

REMOTE. SPOOLER 

FILE NAME OWNER LENGTH TYPE OWNER ACCESS WORLD ACCESS 
9E.DIR А 00123 DATA D R H 


This example copies the spooler directory to the file :F1:PRINT.LST, then copies 
it to the spooler printer queue. 


This example lists all available volume root directories. 


-[ Т 276 
VOLUME NAME LOCATION ACCESSIBLE 


INDX.531 LOCAL YES 
OMS ЕУ LOCAL YES 
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EXPORT 


Syntax 
EXPORT 
ЕП: Г 106 
EXPORT filenamet ' € ' parameter list)’ ) Т0 queuename «сг» 
pathname/ 
A NOLOG 
where 
AME is the directory identifier assigned to the directory that 
contains filename. 
pathname is a fully qualified pathname to the directory that contains 
filename. 
filename is the name and extension, 17 апу. of the shared file. 


"Cparameter list!) is an actual value that replaces a formal parameter in the 
command sequence definition file. The maximum number of 
parameters allowed is 10. When omitting a parameter from 
the EXPORT file, enter a comma in its place. 


queuename is a string of up to 14 printable characters. Any character 
can be used except slashes (/) or blanks. Queue names 
identify where jobs are sent for execution. 


LOG means a log file (filename.L OG) will be created when the file 
executes completely. Log files record the ISIS console output 
during remote job execution. LOG is the default control. 


NOLOG means no log file is created. 


Description 


The EXPORT command sends user-specified jobs to queues for remote execution. 
EXPORT does not modify existing source files. Temporary files with the extension 
.CS are created, and source files are written to these temporary files along with 
parameter substitution character strings. Filename.CS files are queued for remote 
execution. 


Preparing a Job. The Command Sequence Definition file (.CSD file) is an input file 
specified in the EXPORT command that contains the sequence of commands to be 
executed. The file can contain formal parameters (9600-959). When no extension is 
supplied, EXPORT will assume the default extension .CSD. The Command Sequence 
-Definition file is read and copied to the Command Sequence file (.CS), with actual 
parameters substituted for formal ones. 


The following sample file, PROGI.CSD, will assign logical device names to directory 
files and compile a PASCAL program called PROGI.SRC. 


ASSIGN :F1: TO /WINCH1.VOL/SYSTEM.DIR¢cr> 

ASSIGN :F2: TO /MINCHT.VOUL/PROJA.DIR«cr» 

ASSIGN ЕЗ TO :F2:PHASET1.DIR«cr» 

ТЕТ: ВОМ :Е1: РАЅС86 :F3:PROG1.SRCccr> 

ЕТ: КОН :FT:LINK86 :F3:PROG1.0BJ, :F1:P86RNO.LIB, :F1:P86GRNI.LIB, 4ссг» 
IRBIIPSORNO.LIB, :F1:P86RN3.LIB, :F1:E8087.LIB, :F1:E8087, &«cr» 
tF1:LARGE.LIB TO :F3:PROG1.86 BIND«cr» 
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NOTE 
It is not necessary to put a LOGON command into a .CSD file for the 
IMPORT command. 


Parameters. EXPORT allows up to 10 formal parameters of the format %л (the 
two characters must be adjacent with no intervening space), where л is a digit 0-9. 
These formal parameters can appear anywhere in the Command List Definition. 


Actual Parameters. Actual parameters are character strings (up to 31 characters) 
defined by their position in the parameter list (0 is the first parameter) and separated 
by a comma or a blank. Actual parameters that contain delimiter characters can be 
entered by embedding the parameter in two apostrophes (^ °). EXPORT will allow 
CTL-P (Control-P). in parameters and in its input file, to quote the character that 
follows it. (Control-P literalizes characters in the file.) A NULL actual parameter 
may be specified by adjacent commas in the parameter list. 
АП files used by exported jobs must reside in the network directory files. Files that 
reside on local workstation disk directories are not accessible to other workstations. 
NOTE 
Exported jobs are not executed until the IMPORT command assigns а 
workstation io the job queue. 


To CANCEL a job, use the same filename as the LOG file, but with the .CS 
extension (e.g. TESTIG.CS). 


Possible Error Conditions 


An error will result when 
e — You are not logged on 


* COMM CONNECTION ABORTED: the physical connection between the 
Network Resource Manager and the workstation is broken 


A warning message will appear when 


* No import workstations are currently assigned to the queue 
Examples 
1. This example exports the file PROGI.CSD to the queue SERIESIIIJOBS. 


BMEXPORT-/HINCHT.VOL/PROJA.DIR/PROGT.CSD. TO SITIJOBS LOG«crÓ 
YOUR LOGFILE NAME WILL BE PROGOT.LOG 


2. This example cancels the LOG file PROGOI.LOG. 


MCANCEL, SIIIJOBSCPROGO1,CSO «сг» 


3. This example exports the file TEST.CSD to queue Q001 when no import stations 
are currently assigned to that queue. 


BEXPORT /HINCHT/TEST.CSD.TO G001«cr» 
NO IMPORT STATION CURRENTLY ASSIGNED TO THIS QUEUE 
YOUR LOG FILE NAME WILL BE TESTOA.LOG. 
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FORMAT 


Syntax 
FORMAT :Fn:label 
where 


Еп: 


label 


switches 


Description 


Workstation Commands 


[switches] < cr» 


refers to the directory identifier of the disk to be formatted. 
The value n is the number of the disk drive (0. 9) where the 
blank disk is located. 


is the name to be given to the disk. The syntax of /abel is the 
same as the syntax for filename with up to six characters for 
name and three for extension. Jabel must follow Еп: with no 
intervening space ог comma, as in :FI:MYDISK. 


are one or more of the following, separated with spaces: 


A 


FROM n 


copies all files to the specified disk. If the source 
disk is a system disk, the new disk becomes a 
system disk. 

copies the basic format files and all files with the 
system attribute set. If the source disk is a system 
disk, the new disk becomes a system disk. (The S 
switch functions differently under FORMAT than 
it does under IDISK.) 


specifies the disk drive that contains the files 
needed for formatting. n is an integer 0—9, which 
is the directory assigned to a flexible disk drive. If 
the FROM n switch is not specified, the default is 
to drive 0. If n is not a valid integer 0—9, an error 
message is displayed. 

Specifying :F0: and no FROM n switch, or speci- 
fying :F0: and FROM 0, causes the following error 
message to be displayed: 


CANNOT FORMAT FROM TARGET DRIVE 


The FORMAT command prepares new flexible disks at workstations for use with 
ISIS-III(N) and copies files to the new disks. 


FORMAT cannot be used on single disk drive systems. 


To prepare disks on workstations with single-density disk drives, use the IDISK 


command. 


IDISK copies only the ISIS files with the F attribute. Users can copy all files, or only 
format and system files, or only format files with the FORMAT command. 


Flexible disks are prepared as system or nonsystem disk directories, depending on the 
source disk directories used and the switches specified in the FORMAT command. 


FORMAT copies other files in addition to the basic format files when system disk 
directories are prepared. 
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FORMAT copies only the basic format files ISIS.DIR, ISIS.MAP, ISIS.TO, and 
ISIS.LAB when nonsystem disk directories are prepared. 


Examples 


l. This example creates a duplicate system disk excluding any files that do not have 
the system attribute set. 


FORMAT ЖЕЛ: 167007. SY S: Scr» 


СОРАУ СМС ББ TEM ET EE 5 
D'SpS ОЛ б 
ІЕ5 Б ВЕН 
LS bs.CL] 
ISIS.0V0 


SiS EME LB 


2. This example formats basic nonsystem disk LIB.VI on drive 1. System files are 


not copied. 


NON-SYSTEM DISK 
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IDISK 


Syntax 
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IDISK :Fn:label Lswitches] «cr» 


where 

Еп: refers to the directory identifier of the flexible disk to be 
formatted. The value n is the name of the disk drive (0 9) 
where the blank disk is located. 

label is the name to be given to the blank disk. The syntax of label 
is the same as for filename with up to six characters for name 
and three for extension. /abel must follow Еп: with по inter- 
vening space or comma, as in :FI:MYDISK. 

switches are one or more of the following: 

S formats the new flexible disk as a basic system 
disk directory. If S is not specified, the disk is 
formatted as a basic nonsystem disk directory. 

P specifies single-drive mode. The system prompts 
for output and system disks, pausing to display the 
prompt messages and to allow changing of disks. 
If source and destination drives are the same, the 
P switch is the default. 

FROM n specifies the directory that contains the source disk 
files needed for formatting the new disk directory. 
The value n is an integer 0-9 that is a directory 
assigned to a flexible disk drive. If the FROM n 
switch is not specified, the default is to directory 
0. If n is not a valid integer 0-9, an error message 
results. 

Description 


The IDISK command formats 
workstations. 


new flexible disk directories at ISIS-III(N) 


IDISK copies only the files needed for the basic disk directory (whether system or 
nonsystem). Basic nonsystem disk directories contain only the files needed to format 
disks: ISIS.DIR, ISIS. MAP, ISIS.TO, and ISIS.LAB. For basic system disks, IDISK 
copies three additional files: ISIS.BIN, ISIS.CLI, and ISIS.OVO. 


To copy other files to new disks, use the COPY command. 


Single-Drive Systems. Usc IDISK on single-drive or multiple-drive disk systems. On 
single-drive systems, you are prompted to remove the disk and insert the blank disk. 
When the formatting is completed, you are prompted to insert the original system 


disk. See example 1. 
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Examples 


l. 


һә 


This example formats a new flexible disk in drive 0 as a basic system disk direc- 
tory on a single-drive system. IDISK prompts for the new (output) disk and for 
the system disk. IDISK gives the disk directory the name SYS.V1. To copy other 
files to the newly formatted disk directory, use the COPY command for single- 
drive systems described later in this chapter. 


- PRG no ЕЕ 
SYSTEM DISK 

LOAD OUTPUT DISK, THEN TYPE (CR) 
LOAD SYSTEM DISK, THEN TYPE (CR) 


This example formats a new flexible disk in drive 1 as a basic system disk direc- 
tory and gives the disk the name NSYS.V!. The COPY command copies all 
other nonformat files from the disk in drive 0 to the disk in drive 1. 


БИШЕЙ 


М2 VECES 
SYSTEM DISK 


SFÜ:ATTRIB TO :F1:ATTRIB 
COPIED :F0:COPY TO :F1:COPY 
COPIED :F0:DELETE TO :F1:DELETE 
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e IMPORT 


Syntax 


IMPORT FROM queuename (, queuenamel...«cr» 


where 
e queuename is the name of the queue or queues (up to five) at the NRM. 
а Description 


The IMPORT command allows private workstations to act as public workstations. 
This command makes workstations available to process jobs sent from job queues by 
the NRM. 


& : Users must specify with the IMPORT command the queues that the workstation will 
service. If the queue does not exist, a new queue is created. If the queue does exist. 
the public workstation is added to the list of servers of that queue, and the following 
message is displayed at the import station: 


WAITING FOR A JOB 


Of the workstations serving a queue, the actual workstation that executes the job is 
determined randomly: that is, the job will be executed by the first workstation that 
at becomes available. A properly designed queue naming convention helps to control the 
workstation that executes the job (see "Creating and Naming Queues” in this chapter). 


Jobs Executing on Public Workstations. Remote job execution begins as soon as a 
remote job is available in one of the queues served by that workstation. More than 
one queue can be specified in the IMPORT command; queues are serviced in the 
order they appear in the IMPORT command. Lower priority queues are not sched- 
uled until all higher priority queues are empty. 


When imported jobs start to execute at public workstations, messages are displayed 
e on the public workstations. Incoming jobs automatically log on the owner of the jobs. 


-BEGIN jobname.CS 


where 


jobname.CS is the name of the job imported from the Network Resource 
* Manager queuc. 


When jobs are finished, completion messages are displayed: 
-END jobname.CSD 


Restoring a Workstation. When workstations become public they are unavailable 

for any local processing. Control-C ( t C) will immediately terminate the IMPORT 

mode if no jobs are processing, or as soon as the current remote job execution termi- 

nates. To restore a workstation while a job is executing, press Interrupt | and then 

press Control-C. Interrupt 1 terminates the job, and Control-C restores the 
e workstation. 
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Possible Error Conditions 


An error will occur when 
e You attempt to specify more than five queues 
e A nonexistent file is specified 
e The physical connection between the МЕМ and the workstation is interrupted 
• The total number of queues specified at the МЕМ is greater than 10 
NOTE * 
SYSTAT and CANCEL cannot be used under IMPORT. 


Examples 


l. This example imports files from the queue SERIESIIJOBS. 


IBS 


WAITING FOR А SENS 
-BEGIN COMPLE.CS 


2. This example imports files from two different queues. 


WAITING FOR А ЮВ 
-BEGIN COMPLE.CS 
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LOGOFF 


Syntax 


LOGOFF<cr> 


Description 


The LOGOFF command logically disconnects the workstation from the Network and 
returns directory assignments to the default values. 


This command returns all directory assignments made with the ASSIGN command 
to their original default value. See table 4-3. 


Example 


I. Correct use of the command is 
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LOGON 


Syntax 


LOGON username<cr> 
password< cr > 


where 
username is a string of up to 14 ASCII alphanumeric characters. , 
password is a string of up to 14 ASCII alphanumeric characters. 
° 
Description 


The LOGON command allows individual workstations to access the remote shared 
directories and the network line printer. 


NOTE 
The previous user is logged off automatically if another user executes 
LOGON. 


The username and password must be established at the Network Resource Manager 
by the Superuser. See the NDS-II Network Resource Manager User's Guide 
(134300). 


When the username and the password are not provided. the system prompts for them: 


USERNAME 
PASSWORD- 


When the password is not provided, the system prompts for it: 


-LOGON Disi 
PASSWORD - 


Type your password and a carriage return ( < сг» ). For security, the usernames and 
passwords are not actually printed on the console. 


LOGON establishes communication between the NRM and the workstation operated 
by the username. The NRM verifies the username/password combination and allows 
the username workstation to access the shared network files, to submit print requests, 
and to submit jobs for remote execution. 


If a home directory exists, LOGON automatically assigns :F9: to the user’s home 
directory. The SUBMIT file :F9:ISIS.INI allows the user to automatically make 
directory assignments at LOGON time. à 


NOTE 


Use Control-C ( ^ C) to stop an executing 8086 program. Use Interrupt 1 to 
stop an executing 8085 program. The RESET button causes the user to be 
logged off. 


No network directory assignments, except the user's home directory, :F9:, exist at’ 
LOGON time. Make appropriate assignments with the ASSIGN command before 
network files are accessible. | 
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б Possible Error Conditions 


An error results when 
e The username is not validated at the Network Resource Manager 


“ The network is not running 


e Тһе password is incorrect 
Examples 
БД 
1. Correct use of this command is 
Т - ЕИ И 


PASSWORD -IHG 


or 


2. An attempt to access the network with an invalid username is 


m TUER 
USER NAME NOT KNOWN 


3. An attempt to log on without typing the password with the initial input is 


б -[ КИШ 


PASSWORD- 


4. This example logs on USERB and logs off the previous user at the workstation. 


SOCION C USERB PASIS BS 
PREVIOUS USER LOGGED OFF 


5. This example shows an attempt to log on with an incorrect password. If another 
e user were logged on, he would have been logged off. 


BMLUGUN USER BADPASS«cr» 
USERNAME/PASSWORD MISMATCH 
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NETMAP 


Syntax 
NETMAP [х1 «cr» 
where 


x is any integer 0-9 inclusive. ” 


It 0, МЕТМАР restores the workstation's device configuration to the default as shown 
in table 4-3 earlier in this chapter. 2 


If 1-9, NETMAP makes at least x number of network directories available to the 
workstation. 


If an integer is not specified, NETMAP reports the current status of available local 
and network devices. 


Description 


This command maps local devices to network directories. NETMAP enables users to 
increase the default number of network devices. Network devices can be more desir- 
able than local devices because they provide multiple directories. Local devices only 
provide single directories. 


NETMAP also reports the current status of the workstation’s device configuration. 


The maximum number of network devices that a system can support is nine. 
NETMAP will not allow users to decrease the number of network devices below the 
default number. The minimum number of local devices is one. Physical device 0 must 
be available for the user to initialize the system. The system’s hardware configuration 
determines the number of default local and network devices. See table 4-3. 


Changing Device Configuration 


NETMAP allows users to change the device configuration and, subsequently, to 
restore the default device configuration. To change the device configuration, type 


BNETMAP x «cr»? 


where 
x is the number 1-9 that represents the new number of network 
directories to be made available. 


То restore systems to the default device configuration, type 


ММЕТМАР 0 «cr» 


NOTE 


If users request fewer network devices than the number of network devices 
available by default, NETMAP makes all local devices available, then maps 
the rest of the devices to the network. 
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Listing the Device Configuration 


NETMAP can report the current status of the system's device configuration. Drive 
numbers for the local devices and the number of network directories are listed. To 
generate such a listing, type 


NETHORK DEVICES: 5 


Accessing Available Devices 


МЕТМАР makes local and network devices available to the user. However, available 
devices are inaccessible to the user unless the devices have directory identifier assign- 
ments. When the system is initialized, directory identifiers for the local devices are 
automatically set to the default values listed in table 4-3. 


Network directories, however, are not automatically assigned logical device names. 
(:F9: is an exception because this directory identifier is automatically assigned to the 
user's home directory at log on time.) ASSIGN must be used to access available 
network directories by assigning the network devices directory identifiers. 


NETMAP's operations can impact directory identifier assignments. When assigned 
devices are removed from the device configuration, NETMAP reassigns their direc- 
tory identifiers to the NULL device. Users are always warned about directory identi- 
fier reassignments with such messages as :Ғ4:, ASSIGNED TO NULL (WAS 
LOCAL). 


When removing assigned local devices, NETMAP removes the devices with the highest 
drive numbers first. For assigned network directories, NETMAP generally removes 
the network directories that were last assigned. Use the ASSIGN command to obtain 
the current listing of directory identifier assignments. 


Possible Error Conditions 


e NETMAP will execute only on versions of ISIS-III(N) V2.1 or later. 


e User is not logged on. 


Notes 


1. NETMAP makes additional network directories available. ASSIGN makes the 
available network directories accessible. 


2. МЕТМАР removes the directory identifier assignment when an assigned device 
is made unavailable. Reassigned directory identifiers are assigned to the NULL 
device. 


Examples 


1. The following example checks the current device status. NETMAP reports that 
local physical drives 0-4 and five network devices are currently available. The 
user then restores the default device configuration. 


ММЕТМАР«сг» 


LOCAL DEVICES: 0- 
NETWORK DEVICES: 
ыстар 0 cord 


4 
5 
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2. Іп this example the user checks the current device configuration. NETMAP 
reports that l'our local devices and six network devices are currently available. 
Тһе user then requests the maximum number of nine network devices. NETMAP 
maps three of the four local devices to network devices. Because all four local 
drives had been assigned, NETMAP removes and reassigns the drives with the 
highest drive numbers (e.g., drives 3, 2, and 1). The user is warned that the 
directory identifiers have been reassigned and that the maximum number of 
network devices has been reached. 


LOCAL DEVICES: 0-3 
NETHORK DEVICES: 6 
BAUR Ке 


атти TO NULL (HAS LOCAL) 
:F2:, ASSIGNED TO NULL (HAS LOCAL) 
:Ғ3:, ASSIGNED TO NULL.CWAS LOCAL) 


3. After the NETMAP command sequence is executed as shown in example 2, the 
user checks the current device configuration. NETMAP reports that local drive 
0 and nine network directories are now available. 


- ШЕ 
LOCAL DEVICES: 0 
NETWORK DEVICES: 8 


4. After NETMAP reports that local drive 0 and nine network directories are avail- 
able, the user specifies the ASSIGN command to check the current directory 
identifier assignments for the available local and network devices. 


DEVICE ASSIGNED TO 
8 18118 DRIVE 0 
БІРДЕН NULL 
Siria NULL 
"ES NULL 
ЕСА /240/IS8IS3.DIR/SOURCE.DIR/INCLUD.DIR 
FG /1940/ISISS3.DIR/SOURCE.DIR/CUSP.DIR 
:F6: NULL 
SERES /M/ISISS.DIR/LIST.DIR/CUSP.DIR 
:F8: /240/ISIS3.DIR/TARGET.DIR 
16593 /040/ISISS3.DIR 
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QUEUE 


Syntax 
ADD 
ame [,...1) 
QUEUE eese] C queuen > «сг» 
where 
queuename is a string of up to 14 printable characters. Any character 

can be used except slashes (/) or blanks. queuename identi- 
fies where the job is sent for execution. 

Description 


QUEUE allows the user to create and to delete queuenames for remote job execution. 


Possible Error Conditions 


An error occurs when 

e You are not logged on 

o You use illegal syntax 

• You use QUEUE under IMPORT 
e You use a nonexistent queuename 


• There are too many queues 


Examples 


1. This example adds the job queues SERIES2 and SERIES3 to the network. 


SERIES2, SERIES3, ADDED 


2. This example deletes the queue SERIES2 from the network. 


BUE ЕСО ТЕЧЕТ ТЕТЕ 
SERIES2, DELETED 


3. This example attempts to execute the nonexistent default of the QUEUE 
command. 


МӘСЕЛЕ cr» 
ILLEGAL SYNTAX 
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REMOVE 


Syntax 


SENS 


REMOV 
ЫШ dM 


where 


АЕТ}: 
раїһпате 


directory name 


Description 
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| directory name« c г > 


is the directory identifier assigned to the parent directory of 
the file to be removed. 


is the complete fully qualified pathname of the parent 
directory. 


is the name of the directory to be removed. 


The REMOVE command removes data and empty directory files from the parent 
directory. To remove files from the file system, directory files must be empty and you 
must have access to the files. 


The sample file structure in figure 4-2 has an empty directory file DIRA. To remove 
this file from the file system, type 


JWINCHT.VOL/SYSTEM.DIR/DIRA, REMOVED 


or 


- ЕШ 
REMOVE 


БЕЗ ЕТП ЕЛЬ 
ТЕЗ БО ERA Сс г» 


SY WCENIC HITS. QE бИ ТЕ 


:F3:DIRA, REMOVED 


Possible Error Conditions 


An error will result when 


* You are not logged on 


* Тһе directory file is not empty 


* Any user attempts to remove a directory file and does not have delete access 


rights to the file 


e You attempt to remove a directory file from the local file system 


Examples 


l. This example shows a successful attempt to remove the empty directory file DIRC 
from the file system: 


BREMOVE /MHINCH1.VOL/DIRB/DIRC«cr» 


/WINCHT.VOL/DIRB/DIRC, REMOVED 
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LOGICAL 
SYSTEM 
ROOT 


WINCH1.VOL 


SYSTEM.DIR DIRD.EXT FILES.EXT 


FILE T.EXT 


FILE4.EXT 


FiLE3.EXT | 


Figure 4-2. Hierarchical File Structure 121765-6 


ә 


This example shows an attempt to remove the empty directory DIRA without 


ё the proper access rights: 


BREMOVE ZWINCHT-VOLZSYSTEN.DIRZDIRACerÓ 
/|MINCHT.VOL/SYSTEM.DIR/DIRA,NETHORK 
FILE ACCESS RIGHTS VIOLATION 


3. This example shows an attempt to remove the directory SYSTEM.DIR that is 
not empty. 


BMREMÜVE /MINCHT.VOüL/SYSTEM.DIR«cr? 


e /WINCH1.VOL/SYSTEM.DIR, ATTEMPT TO DELETE А NON-EMPTY DIRECTORY 


4. То delete files that have non-ISIS filenames, type the exact filename. This 
example removes the file 'FILE.TMP3'. 


REMOVE /HINCH1.VOL/SYSTEM.DIR/'FILE.TMP3'«cr) 


/IMINCHT.VOL/SYSTEM.DIR/'FILE.TMP3',REMOVED 
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RENAME 


Syntax 


RENAME [:Fn:)] oldname TO [:Fn:] newnameccr> 


where 
“Ет refers to the directory identifier of the directory where the * 
file resides, and must be the same for both o/dname and 
newname. 
. 22. š е 4 
oldname is the name of an existing file whose write-protect or format 


attribute is not set. o/dname follows :Fn: with no intervening 
space, as in :F2:M YPROG. 


newname is the new name to be assigned to oldname. The newname 
follows :Fn: with no intervening space, as in :F2:PROGI. 


Description 
The RENAME command changes the name of files. 
Enter the RENAME command to change the name of an existing file to a new name 


that does not already exist; the system changes the directory. Wildcards cannot be 
used. 


However, if another file with the new name already exists, the system displays the 
following message: 


newname, ALREADY EXISTS, DELETE? 


To delete the existing file, enter a Y or y followed by a carriage return. RENAME 
will delete the existing file and change the name of o/dname in the directory. 


If the existing file to be deleted is write-protected or a format file , or if you enter 
any character other than Y or y, the existing file is not deleted and the file to be 
renamed is not renamed. 


NOTE 


RENAME cannot be used on nonsystem disks on single drive systems. To 
change the name of a nonsystem disk directory file with only a single drive, 
use the COPY command to copy the file to a file with the new name, then 
delete the old file with the DELETE command. 


Possible Error Conditions 


An error occurs when 
* You are not logged on 
*  oldname is a nonexistent file 


le The device is not assigned 


œ You do not have proper access rights 
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Examples 


ДЕ 


һә 


This example changes the name of the file СНАРІ on directory 0 to CHAP.ONE. 


МРЕНАМЕ CHARA TO CHAP.ONE<cr> 


This example illustrates an attempt to rename the file NEWPRG.TXT with no 
delete access. 


RENAME NEIPRG-  DXT TOE PROG AN ТАТ Сс г> 
NEWPRG.TXT, WRITE PROTECTED 


In this example, the new name TEXT.OLD is the name of an existing file. 


RE HIRI j GSEs: 3 2, 
TEXT OLD, ALREADY EXISTS, DELETE? 


This example attempts to rename the file :F6:OLDFILE and move it to another 
disk or directory. 


IL, NOT. ON SANE DISK 


This example shows an attempt to change a network filename to a filename from 
the remote directory. 


BRE NAME SEO | 
ALRDY.USD, ALREADY EXISTS 


To rename files in the remote network file system, assign directory identifiers to 
the directories first. 


TVOUUME ZMY BOOK сг» 
5ЕЗ:СНАР2<сғ» 


ЕЗ0 
ЕЗ: CHAP 4B TO 


BASS IGN 
МРЕМАМЕ 
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Syntax 


SPACE /volume пате«сг» 
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where 
/ volume name is the volume root directory (e.g., /VOLI.A) for the given 
physical device. 
Description 


The SPACE command returns information about the amount of available space on 
any given disk at the time the request is made. Information is returned in the follow- 
ing format: 


VOLUME GRANULARITY = 


FREE BLOCKS = 
TOTAL BLOCKS z 
FILES AVAILABLE S 


ТАПИХА ШЕ БИШЛЕ С = 
mm/dd/yy hh:mm:ss 


where 


number (granularity = number of bytes/sector) 
number 
number 
number 
number 


mm/dd/yy hh:mm:ss 15 the month, day, year, hour, minutes, and seconds. 


number is a decimal integer. 


NOTE 


In a multiprogramming environment, the amount of space is used by others. 
Therefore, the information returned by the SPACE command should be 


considered an approximation. 


Possible Error Conditions 


An error occurs when 


You are not logged on 


The volume name does not exist 


Illegal syntax of pathname is used 


Example 


l. 


provided. 


ШОРАСЕ /У011.А<сг» 


VOLUME GRANULARITY 
FREE BLOCKS 

TOTAL BLOCKS 

FILES AVAILABLE 
TOTAL FILES 

1/5/83 


In this example information for the volume whose root directory is /VOLI.A is 


о 
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SUBMIT 


Syntax 


SUBMIT [:Fn:) filename LCparameterL, ...1)) «cr» 


where 
“Еп is the directory identifier of the directory ог drive where the 
file resides. 
filename is the name (and extension, if any) of the file that contains 


the command sequence definition. If the extension is omitted, 
SUBMIT assumes the default extension .CSD. 


parameter is an actual value that is to replace a formal parameter in the 
command sequence definition file. The maximum number of 
parameters allowed is 10. If you omit a parameter from the 
SUBMIT list, enter a comma in its place. 


A parameter is a character string of up to 31 characters. Any 
ASCII character from 20H to ТАН is legal, except а comma, 
space, or right parenthesis. If a parameter contains a comma, 
Space, or right parenthesis, enclose the parameter in 
apostrophes. To use a quotation mark inside a quoted param- 
eter, use two quotation marks in its place. For example, 


'TITLEC"QUOÜTE (") SEARCH ROUTINE")’ 
is used in the final command as 


TITLEC'GUUÜTE (”) SEARCH ROUTINE’) 


Description 


The SUBMIT command causes ISIS-III(N) to take its commands from a file rather 
than from the console. 


SUBMIT uses two files: 


A command sequence definition (CSD) file that contains the command sequence 
definition. Create this file with formal parameters, using the editor. 


A temporary .TMP file that contains the command sequence to be executed. 


SUBMIT creates this file with the actual parameters supplied in the SUBMIT 
command that replaces the formal parameters. The temporary file has the same 
name as the command sequence definition file but with the extension .TMP. Do 
not modify this file. 

SUBMIT reassigns the console input device to the .TMP file and returns control 
to ISIS-III(N). ISIS-III(N) then executes the commands in the .TMP file. .TMP 
files have the final command that restores the console input device to its former 
device assignment and deletes the .TMP file. 


When creating the CSD file, specify formal parameters by using two characters, %n, 
where n is a digit from 0—9. You may place formal parameters anywhere in the CSD 
file. To enter a percent sign (96) that is not to be interpreted as a formal parameter, 


enclose it in apostrophes. 


4-53 


Workstation Commands NDS-II ISIS-III(N) 


Any program, except LOGON, LOGOFF, or IMPORT, that reads its commands | 
from :CI: noninteractively can be executed. 


CSD files can also contain commands to the programs being executed. Using a 
SUBMIT command in a CSD file causes another .TMP file to be created. SUBMIT 
commands can be nested to any depth. 


CNTL-E ( * E) in a .TMP file switches the console input from the .TMP file to the 


initial system console, allowing interactive processing. To return control to the .TMP А 
file, enter CNTL-E at the console. If control is пог returned to the .TMP file, or if 
an error occurs after a command sequence has started processing, control returns to 
ISIS-III(N), and the . TMP file is not deleted. d 


Any program running under SUBMIT must allow for two buffers in addition to the 
open files and buffers required by the program itself. See the /ntellec Series III 
Microcomputer Development System Programmer's Reference Manual (121618) for 
information on how to determine the base address of your program. 


Possible Error Conditions 
Do not use LOGON, LOGOFF, or IMPORT commands in SUBMIT files unless the 
SUBMIT file is from a workstation flexible disk directory. Including either of these 


commands in the file causes an error message at the workstation. 


ILLEGAL LOGON WHILE :CI:/:C0: FILE ON NETWORK 


or 


ILLEGAL LOGOFF WHILE :CI:/:C0: FILE ON NETWORK 


Example 


1. This example shows a PL/M-80 compilation, a LINK, and a LOCATE executed 
from a SUBMIT file on a two flexible disk drive system. A CNTL-E is entered 
in the command sequence definition after the PL/M compilation so you can 
remove the compiler disk. When the regular system disk (with LINK and 
LOCATE) is mounted, you enter CNTL-E to resume processing. The EDIT does 
not echo the ^ E; however, it is echoed when the SUBMIT file is executed. 


The file CMPLNK.CSD in drive 1 contains the following command sequence 
definition. See the MCS-80/85 Utilities User's Guide for 8080/8085-Based 


Development Systems (121617) for an explanation of controls in the PL/M-80 , 
command. The CMPLNK.CSD file contains 
PLM80 20.41 DEBUG XREF DATEC%2) ? 


ТЕ 

LINK 20.0BJ,SYSTEM.LIB TO Х0.5АТЕ 
PRINTCX0.MP1) MAP 

LOCATE X0.SAT PRINT (%0.MP2) MAP 


The SUBMIT command entered to compile, link, and locate PROGA.SRC is 


BMSUBMIT :F1:CMPLNK C:F1:PROÜGA,SRC, '3 OCT 81, ) ‹сг› 
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The command sequence actually executed is shown as it would be echoed on the 
console output device: 


-PLM80 :Fi:PROGA.SRC DEBUG XREF DATE(C3 OCT 81) 


ISIS-II PL/M-80 COMPILER V3.1 
PL/M-80 COMPILATION COMPLETE 0 PROGRAM ERRORCS) 


- ^ Eli] 

-LINK :F1:PR0GA.0BJ, SYSTEM.LIB TO :F1:PROGA.SAT & 
**PRINTC:F1:PROGA.MP1) МАР 

-LOCATE :F1:PROGA.SAT PRINTC:FI:PROGA.MP2) MAP 
-iF0:SUBMIT RESTORE :F1:CMPLNK.TMPC:VI:) 
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SYSTAT 


Syntax 


SY STAT ІШІ [queuename , диеиепате...1 Llswitchl«cr» 


MYJOB 
> 
where 
QUEUE lists all of the names and numbers of jobs currently in the 
queues, or it lists a specific queue, the job status, and the ^ 
names of the users who own the jobs. 
MYJOB lists the names, numbers and status of jobs exported to a 
specilied queue by the current user. 
queuename is the name assigned to а queue where the job was sent to 
await execution. 
switch is E that specifies expanded listing. All cancelled, aborted, 
executing. and waiting Jobs are listed. 
Description 


The SYSTAT command lists remote job queues and reports the jobname, jobnum- 
ber, and the job status. 


Listing Active Queues. To list all active queues, type 


QUEUE NAME JOBS IMPORT 
WAITING STATIONS 
SIIIJOBS 6 2 
SIIJOUBS 3 1 
LOWPRIQRJOBS 4 0 
where 
QUEUE NAME is the list of all currently active queues. 
JOBS WAITING is the number of jobs in that queue waiting to be 
executed by an import station. * 
IMPORT STATIONS is the number of workstations currently serving jobs 
from this queue. 
” 


Listing A Specific Queue. То list all jobs in a queue, type 


BSYSTAT QUEVE (5111008В5)‹сг› 


QUEUE OWNER NUMBER DATE TIME STATUS 
QUEUE:SIIIJOBS 

TEST.CSD JOHN АЗ 12/02/82 09:30:00 WAITING 

COMPLE.CSD SHEILA 27 12/02/82 10:37:34 WAITING 

TEST.CSD РЕШЕ 18 12/01/82 04:03:12 EXECUTING 
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where 
e QUEUE is the name of the queue requested. 
OWNER is the owner of a specific file in the queue. 
NUMBER is the job number assigned by the Network Resource Manager 


when the job was exported. This unique hexadecimal number 
is assigned to avoid system confusion between two jobs of the 
same name with different owners. Job numbers can also be 
used in the CANCEL command. 


* DATE is the date that the job was exported to the queue. 
TIME is the time that the job was exported to the queuc. 
Ж STATUS is the current status of the job: 


ABORTED--the job was interrupted before it was 
completed. Reviewing the log file will help to determine the 
cause. 


CANCELLED--the job has been cancelled by the owner ог 
272 the Superuser. 


DONE -the job has been executed successfully and is 
completed. 


EXECUTING —the job is currently executing at an import 
station. 


WAITING —the job is waiting in the queue to be executed 
by an import station. 


e Possible Error Conditions 


An error will occur when 
e You are not logged on 
• A specified queue does not exist 


e А job does not exist 


е Examples 


1. This example lists all active queues. 


Ы5/5ТАТ<сг>» 


QUEUE NAME JOBS IMPORT 
2 MAITING STATIONS 
SIIIJOBS 6 2 
SIIJOBS 3 1 
А LONMPRIORJOBS 4 0 
2. This example lists all jobs in the SIIIJOBS queue. 
BSYSTAT QUEUE (SITIJOBS) cerol 
QUEUE OWNER NUMBER DATE TIME STATUS 
QUEUE:SIIIJOBS 
TEST.CSD JOHN АЗ 12/02/82 09:30:00 WAITING 
COMPLE.CSD SHEILA 27 12/02/82 10:37:34 WAITING 
TEST.CSD PETE 1A 12/01/82 04:03:12 EXECUTING 
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3. This example lists the status of all jobs exported by one user. 


MSYSTAT MYJOB cer? 


JOB NAME NUMBER DATE TIME STATUS 
QUEUE:SIIIJOBS 

COMPLE.CSD 27 12/02/82 10:27:34 WAITING 
QUEVE: STI JOBS 

TEST.CSD 2A 12/02/82 09:30:00 WAITING 

MYPROG.CSD 19 12/01/82 08:57:04 EXECUTING 


QUEVE:LONPRIORJOBS 
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VERS 


Syntax 
VERS command<cr > 
where 
command is one of the ISIS command programs. 
Description 


The VERS command lists the version number of the ISIS-III(N) operating system 
command programs. 

The VERS command identifies the version number of the different versions of ISIS 
Operating system command programs. Each version works correctly only with the 


corresponding version of ISIS. 


ISIS-III(N) operates with any command program that displays a version number 
followed by N and has a version number 2.1 or greater. Other Intel software, such as 
editors and translators, do not contain version numbers. 


Examples 


|. This example successfully lists the version number of a compatible ISIS-III(N) 
command program. 


МУЕР5 DIR eins, 


V2. 1N 
2. This example shows an attempt to list the version number of the user file 
MYFILE.EXT. 


BMVERS MYFILE.EXT€crO 


file does not contain a program version number 


3. This example shows an attempt to list the version number of the file NONFLE 
that is not in the directory of the target device. 


HVERS NONFLE«cr» 
ERROR 13 USER PC 375В 


4. This example lists the version number of the command program VERS. 


HVERS VERS«cr» 
V2.1N 
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WHO 


Syntax 


WHO «cr» 
Description 
The WHO command displays the name of the user who is currently logged on. 


Possible Error Conditions 


An error will occur when 


e You are not logged on 


Example 


1. This example displays the name of the user. 


1 AM SUSAN 
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WORKSTATION SYSTEM CALLS 


This chapter summarizes all changes in the ISIS-III(N) system calls and lists the 
ISIS-IIICN) routines available on the NDS-II system. Only those routines that are 
not identical to those documented in the 7S/S-/] User's Guide (9800306) are 
described. 


Differences between ISIS-III(N) and ISIS-II 

Shaded text throughout this chapter highlights the differences between the 
ISIS-IHI(N) and the ISIS-II operating systems. 

Revised System Calls 


In ISIS-III(N), the ATTRIB, GETATT, GETD. and SPATH system calls are slightly 
different. 


The ATTRIB and the GETATT calls recognize only the write-protect attribute for 
a network file. АП attributes are valid for local files. 


The GETD call accesses information from the file system of the Network Resource 
Manager as well as from the workstation. 


The SPATH call defines a new directory type for the NDS-II remote mass storage. 


New System Calls 


The CHGACS call allows the owner to change the owner or world access rights of a 
file. 


The DETIME call returns the current date and time. 


Тһе FILINF call provides security and accounting information on files. 


Summary of System Calls 


ISIS-ILI(N) services that can be called by a program include 


•  Input/output operations for the disk directories and the standard Intellec Periph- 
eral devices (FILINF, OPEN, CLOSE, READ, WRITE, SEEK, RESCAN, 
SPATH) 


NOTE 
:SP: is a queuename and should not be used in programmatic calls. 
e Disk directory maintenance (ATTRIB, CHGACS, DELETE, GETATT, GETD, 
| RENAME) 


© Console device assignment, error message, and date and time output (CONSOL, 
WHOCON, ERROR, DETIME) 


e Program loading and execution and return to the supervisor (LOAD, EXIT) 
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For descriptions of these system calls, refer to the ZSIS- User's Guide. 


To call ISIS-III(N), specify the services desired and the address of the parameter 
list. Note that an ISIS routine does not affect the user stack depth, and that calls to 
ISIS-IHI(N) destroy the contents of the CPU registers. 


System call descriptions include discussion of the call's operation and the parameters 
the program must supply. 


To clarify the effect of certain system calls on files, two integer quantities (LENGTH 


and MARKER) are associated with each file. LENGTH indicates the number of Y 
bytes in the file. MARKER indicates the number of bytes already read or written in 
the file (that is, it acts as a file pointer to the current position). E 


System Call Syntax and Usage 


ISIS-III(N) system routines can be called from PL/M-80 or Assembly Language 
programs. Link the object program with SYSTEM.LIB using the LINK program if 
the program makes an 1515-ІП(М) system call. 


SYSTEM.LIB, the library file supplied with the ISIS-III(N) system disk directory, 
contains the procedures necessary to interface the user's programs that contain 
ISIS-III(N) system calls with the ISIS-III(N) operating system. 


PL/M-80 Calls 


PL/M-80 programs can interface to ISIS-III(N) by performing calls to procedures 
in SYSTEM.LIB. Programs must include external procedure declarations so the 
proper procedures from SYSTEM.LIB will be included with the program by LINK. 
These external procedure declarations can be declared as type ADDRESS, but can 
also be values as well as addresses of values. 


Assembly Language Calls 


The interface between the 8080/8085 Assembly Language program and ISIS-III(N) 
is accomplished by calling the desired ISIS-III(N) routine. АП system calls conform 
to the interface described in the ZSIS- User's Guide. 


The ISIS-III(N) entry point is defined in a routine in SYSTEM.LIB that must be 
included in the program. When using LINK, specify the name of the program followed 
by the name SYSTEM.LIB. See the МС5-80/85 Utilities User's Guide for more 
information on LINK. 


System call references can be defined in EXTRN statements before they are refer- 
enced in programs, thereby allowing programs to reference the system call routines 
symbolically. Only the specific system calls needed by the program need be defined. 
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ATTRIB 


The ATTRIB call allows your program to change attributes of directory files. 


You must pass four parameters in the ATTRIB call: 


tke 


t2 


path$p, the address of an ASCII string that contains the name of the file whose 
attribute is to be changed. The string can contain leading space characters but 
cannot contain embedded spaces. The string must be terminated by a character 
other than a letter, digit, colon (:), or period (.). A space can be used. 

atrb, a number that indicates which attribute is to be changed. The numbers are 


0— invisible attribute 

1— system attribute 

2— write-protect attribute 

3—format attribute 
Only the write-protect attribute (2) may be set or reset on remote files. This 
attribute will set or reset the access right switches (owner write, owner delete, 
world write, and world delete) of the remote file. 
onoff, à value that indicates whether the attribute is to be set (turned on) or reset 
(turned off). The value is stored in the low-order bit of the low-order byte. A 
value of 1 specifies that the attribute be set; a value of 0 specifies that it be reset. 


status$p, the address of a memory location for the return of nonfatal error 
numbers. 


Nonfatal error codes returned: 4, 5, 13, 23, 26, 28, 61, 66, 70 
Fatal error codes returned: 1, 24, 30, 33, 63, 64, 65 
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CHGACS 


Syntax 
CALL CHGACS (Cpath$p, class, access, status$p) 


The CHGACS call requires four parameters: 

l. path$p, a 16-bit pointer to a string containing the pathname of the file whose 
access rights are to be changed. 

2. class. a l-byte value that specifies the class of users whose access rights are to 
be changed. 


Value Type 

0 owner of file 
1 world 
2-255 reserved 


3. access. a l-byte value that specifies the type of access to be granted to the class 
of specified file users. If all bits are set to 0, the access of the specified user to 
the file is denied. If any bits are set to 1, access is granted as follows: 


Bit Access 

0 delete (data). delete (directory) 

1 read (data). display (directory) 

2 write (data), add-entry (directory) 
3 update (read and write) 


4. status$p, a 16-bit value that specifies the address of a memory location for the 
return of a nonfatal error. 


Standard Exception Codes 


The following exception codes that are returned to the user are equivalent to 
Series ПІ UDI exception codes: 


Е%0к (0000H) 

ESFNEXIST (0021H) 
ESFACCESS (0026H) 
ESSUPPORT (0023H) 


Description 


The CHGACS call allows the user to change the owner or world access rights of 
files. Files whose access rights are to be changed are assumed to be open before the 
CHGACS call is made. 


NOTE 

On remote files the privilege to use the CHGACS function is granted only 
to the owner of the file. The granting of this privilege to other users is operat- 
ing system dependent. If the privilege is not granted, the system returns the 
error ESFACCESS. The error ESFNEXIST indicates that the file does not 
exist. If the user attempts to change the access rights of a nondisk file, the 
error ESSUPPORT is returned. The access rights of the file are changed 
immediately but do not affect other connections to the file until they аге 
detached. 
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On local files the ISIS write-protect and format attributes are set to zero if 
e delete and write access are requested. Otherwise, the write-protect attribute 
is set to one. 


Example 


1. PL/M-80 CHGACS Call 


CHGACS: 
. PROCEDURE (Cpath$p, class, access, status$p) EXTERNAL; 
DECLARE path$p address , 
class byte, 
% access byte, 
status$p address ; 


END CHGACS; 


DECLARE ABCSDEFC*D) BYTE INITIAL (11,’:F1:ABC.DEF‘); 
DECLARE OWNERSCLASS LITERALLY 707; 


9 DECLARE WORLDSCLASS LITERALLY ‘1°; 
DECLARE DRWSACCESS LITERALLY ‘07H‘; 


DECLARE CENTRY,EXCEP,STATUS) ADDRESS; 
DECLARE AFTN ADDRESS; 


CALL OPENC.AFTN,.ABCSDEF(1),1,0,.STATUS); 
CALL LOADC.(’71S1S.0V2‘),0,0,.ENTRY,.STATUS); 


CALL CHGACSC.ABCSDEF,OWNERSCLASS,DRWSACCESS,.STATUS); 
IF STATUS«» THEN ERROR... | 
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Syntax 
CALL DETIME Cat$p, status$p) 


The DETIME call requires two parameters: 
l. at$pis a pointer to user declared structure in the following form: 


DECLARE DT STRUCTUREC 
sysS$time$lo address , 
sys$time$hi address , 
date(s) byte, 
тес 8) byte) ; 


where 

sys$time is a formatted double address that contains the date and 
time. If sys$time is zero, the system clock is read first to 
obtain the current date and time. If sys$time is not zero, 
it is simply decoded into ASCII date and time strings. 
sysStime contains the binary format of the current date 
and time if selected by the input value zero. The speci- 
fied format is in seconds beginning with 1/1/78. 

date has the form mm/dd/yy for month, day, and year. The 
value for hours ranges from 0 through 23. 


2. status$p is the address of a memory location for the return of a nonfatal error 


number. 
Standard Exception Codes 


Е%0К (0000H) 


NOTE 


On remote files, the date and time that is maintained at the NRM is returned. 
On local files, the date and time of 0 is returned (e.g., 00/00/00 00:00:00). 


Description 

Тһе DETIME call decodes the sys$time$lo and sys$time$hi variables into ASCII 
date and time strings. It may also be used to return the current date and time in 
either binary address format or as a decoded ASCII string. 

Example 


1. PL/M-80 DETIME Call 


DETIME: 
PROCEDURE (ар, status$p) EXTERNAL; 
DECLARE аїр address , 


status$p address ; 
END DETIME; 
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DECLARE DT STRUCTUREC 


sys$time$lo address , 
sys$time$hi adaress , 
dateC 8) byte , 
time( 8) byte) ; 


DECLARE CENTRY,EXCEP,STATUS) ADDRESS; 
CALE LOAD €.C 1S 1S. 0 V2) , 0:0), = ENTRY ТАТО; 
DT.SYSS$TIMES$LO,DT.SYSS$TIMES$HI = 0; 


CALL DETIME C.DT,.STATUSO 
IF STATUS «» 0 THEN CALL ERROR CSTATUS) 
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FILINF 


Syntax 


CALL FILINF (CfileStable$p, mode, fileSinfo$sp, status$p) 


The FILINF call requires four parameters: 9, 


l. fileS$table$p, points to a structure of the form 


DECLARE fileStable structure C 
aftn adaress , 
deviceSnum byte, 
пате 62 byte , 
extension( 3 ) byte, 
deviceStype byte, 
driveStype byte) ; 

where 

aftn contains the active file table number of the open file on 


which security and accounting information is desired. 


аеуісе$пит, contain information normally returned from the SPATH 
name, extension, call. 

device$type, 

driveStype 


гә 


mode indicates whether the file owner is to be identified. Byte 0 indicates that 
the owner name or identification is not to be returned. Byte | indicates that the 
owner name or identification is to be returned. 


3. fileSinfo$p points to the structure that the user declares to receive the Ше infor- 
mation. The structure form is 


DECLARE FILES$INFO STRUCTURE 


Cowner( 15) byte , á 
length$of$file C 2 ) address , 

type byte , 

owner$access byte, a 
world$access byte, 

create$time( 2) address , 

last$mod$time( 2) address , 

reserved C 20) byte) ; 


For remote files these fields are interpreted as follows: 
owner—the string that identifies the system name of the file owner 
length$of$file—the length of the file in bytes 
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type—an indication of the usage of the file where the type is indicated by 
the following values: 


Value Type 
0 data file 
І directory file 
2 reserved 
225 


owner$access, world$access- describe the owner and world file access rights 
where 


Bit Access 

0 delete (data), delete (directory) 

1 read (data), display (directory) 

2 write (data), add-entry (directory) 
3 update (read and write) 


4-7 reserved 


createStime-—-indicates the date and time of the creation of the file. Contents 
of the time ADDRESS array is the number of seconds since 1/1/78. 


last$mod$time—indicates the date and the time of the last modification of 
the remote file. It is a 4-byte array. 


For local files the fields are interpreted as follows: 


4. 


owner-—the string that is of the form 4, ISIS 
length$of$file—the length of the file in bytes 


type—the following values that indicate whether the file is data or an ISIS 
directory 


Value File Type 
0 data file 
І ISIS directory file 


owner$access, world$access— describe the owner and world file access rights. 
When the file is write-protected or the format attribute is set, the following 
bits are on: delete, read, and write. 


If the file is not write-protected, or the format attribute is not set, only the 
read bit is on. 


create$time—the time is always set to 0. 


status$p, the address of a memory location for the return of a nonfatal error 
number. 


Standard Exception Codes 


The following exception codes that are returned to the user are equivalent to 
Series III UDI exception codes: 


Е%0К (0000H) 
ESSUPPORT (0023H) 
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Description 
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The FILINF call allows the user to determine security and accounting information 
about files. Files for which the FILINF function is invoked are assumed to be opened 
before the FILINF call is made. If the file for which FILINF is invoked does not 
have the read bit on, an error occurs. 


Example 


|. PL/M-80 FILINF Call 


PIECE 8 


PROCEDURE (CfileStableS$p, mode, fileSinfo$p, 


EXTERNAL; 


DECLARE 


END FILINF; 


DECLARE 


DECLARE 


fileStableSp 
mode 
fileSinfo$p 
status$p 


FILESINFO STRUCTURE 
owner( 15) 

length C 2 ) 

type 

ownerSaccess 

world$access 

createStime ( 2 ) 

lastSmodStime ¢ 2 ) 

reserved ( 2 0 ) 


fileStable 

aftn 
device$num 
name( 6) 
extension 3 ) 
device$type 
drive$type 


status$p) 


address ; 
byte, 

adaress , 
address ; 


byte , 
adaress , 
byte , 
byte , 
byte , 
address , 
address, 
byte) ; 


structure € 
address , 
byte, 
byte, 
byte, 
byte, 
byte) ; 


DECLARE (ENTRY, EXCEP, STATUS) ADDRESS; 


DECLARE ABC$DEF (%) BYTE INITIAL 
DECLARE AFTN ADDRESS; 


CETA BCID ES БИ УЕ 


CALL SPATHC.ABCSDEF,.FILESTABLE.DEVICES$NUM,.STATUS); 


CALL OPENC.AFTN,.ABC$SDEF,1,0,.STATUS); 


CALL LOADC.C'ISIS. OVI 


^2,0,0,.ENTRY,.STATUS); 


CALL FILINFC.FILES$TABLE, 1,.FILES$INFO,.STATUS) ; 
IF STATUS «» 0 THEN ERROR... 
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GETATT 


Syntax 
CALL GETATT (Cfile$pointer, .attrib$p, . status) 


The information is returned in a one byte field (ATT) 


where 
bit 0 set = invisible 
bit | set = system 
bit 2 set = write-protect 
bit 3 = reserved 
bit 4 = reserved, undefined (1 or 0) 
bit 5 = reserved 
bit 6 = reserved 
bit 7 set = format 


Nonfatal error codes returned: 4, 5, 13, 23, 28 


Fatal error codes returned: 1, 24, 30, 33 


Description 


All attributes are valid for local files. Only the write-protect attribute is valid on 
network files. 


The GETATT call allows access to the attribute information associated with the disk 
file pointed to by file$pointer. If the specified file is nonexistent, a nonfatal error 
occurs. 


Examples 
l. PL/M-80 GETATT Call 


GETATT: 

PROCEDURE (path$p, attrib$p, status$p) EXTERNAL); 
DECLARE (Cpath$p, attrib$p, status$p) address ; 

END GETATT; 

/* MUST BE LINKED WITH SYSTEM.LIB */ 


DECLARE FILEC1S) BYTE; 
DECLARE STATUS ADDRESS; 
DECLARE ATTRIB BYTE; 


CALL GETATT C.FILE, .ATTRIBUTE, .STATUS); 
IF STATUS «» 0 THEN... 
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2. Assembly Language GETATT Call 


EXTRN GETATT ; MUST BE LINKED 
i WITH SYSTEM ЗЕ TB 


П 


; GETATT 
LHLD КЕЕ ЕР, ЕБЕ PARAMETER 
PUSH H 
LHLD ATTP ; ATTRIBUTE POINTER » 
PUSH H 
POP B 
LHLD STATP z STATUS ^ 
PUSH H 
РОР D 
CALL ЕТТЕРІ 
LDA GSTAT ; TEST ERROR STATUS 
ORA A 
Heer JNZ EXCEPT ; BRANCH TO EXCEPTION 
; ROUTINE 
REE: Pes DW GFBE к RO ENTER STO «ЕВЕ 
; PATHNAME 
ATTP: DW ATTRIB ; POINTER TO ATTRIBUTE 
S TA TP DM GSTAT ; POINTER TO STATUS 
GFILE: DB Marty ahora ce) Gals | Peacoat, Od ; FILE PATHNAME 
ATTRIB: DS 1 ; ATTRIBUTE VALUE 
; (RETURNED) 
GSTAT: DS 2 ; STATUS (RETURNED) 
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GETD 


Syntax 


CALL GETD (did, .conn, count, .actual, .table, .status) 


The GETD call requires five parameters: 


l. 


did, an address value that contains the number for the directory from which entries 
are to be returned. Valid integer values are 0-9 representing :FO:-:F9:. 

conn, an address value that must be initialized to zero when the first display 
request of a sequence is made. Do not change the value; changing it will cause 
an error. The system then assigns a value that is returned in subsequent requests 
for directory entries. This value acts as a pseudo-connection for all subsequent 
calls. 

count, an address value that contains the number of entries to be returned. count 
— 0 indicates termination of the current display request sequence and releases 
the pseudo-connection. The program must make a final call to GETD with count 
= 0 to release the connection, except when it is released automatically as 
described under actual. 

actual, an address value that contains the number of directory entries returned 
by the system. When the number of directory entries is less than count, the last 
directory entry has already been returned and the pseudo-connection will be 
released automatically. 

table, the address of a memory structure where directory entries are returned. 
The structure form is 


DECLARE ENTRY STRUCTUREC 


reserved! (1) byte, 
file$name (9) byte, 
reserved2 (6) byte) ; 


where 


file$name is a nine-byte field with two subfields left justified and 
zero filled. The first six bytes represent the name; the 
remaining three bytes are the file extension. 


status, the address of a memory location for the return of a nonfatal error number. 
Nonfatal error codes returned: 3, 4, 5, 13, 23 
Fatal error codes returned: 1, 24, 30, 33 


Description 


The GETD call allows access to information in the file directory defined by DID in | 


the workstation and in the Network Resource Manager file system. 


Reserved fields returned by GETD are different from one ISIS-III(N) system call to 
another. Do not use reserved fields in a user program. 


Programs that use this interface will execute correctly on standalone development 
systems (Model 800, Series II, or Series III) or workstations attached to an NDS-II 
network. GETD requires that an ISIS overlay and an NDS-II overlay, ISIS.OVO, be 
loaded into the top of a 64K memory space beginning at 0Е800Н with the LOAD 
system call before calling GETD. The overlay space can be overwritten when this call 
is completed. 
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Access the overlay entry point by linking to SYSTEM.LIB. Avoid overwriting the 
overlay when accessing the desired directory. 


Examples 


1. PL/M-80 GETD Call 


GETD: 
PROCEDURE (did, conn$p, count, actual$p, table$p, status$p) 


EXTERNAL; 

DECLARE (did, conn$p, count, actual$p, table$p, status$p) ADDRESS; 
END GETD; 
DECLARE (dummy, status, conn, actual) ADDRESS; 


DECLARE TABLE (50) STRUCTURE 
(reserved (1) byte, 
filename (9) byte, 

reserved (6) byte) ; 


CONN = 0; 
CALL LOAD C.C':F0:ISIS.0V0O '0,0,0, .DUMMY,.STATUS); 
CALL GETD (1, . СОММ, 50, .ACTUAL, .TABLE (0), .STATUS); 


IF STATUS «» 0 THEN ERROR... 


2. Assembly Language GETD Call 


: GETD 
EXTRN GETD ; MUST BE LINKED 
; WITH SYSTEM.LIB 
; ISIS.0V0 MUST BE LOADED BEFORE CALLING GETD 


LXI н,0 

SHLD CONNP ; INITIAL 0 

LHLD DID ; DIRECTORY 

PUSH H 

LXI H,CONNP ; CONNECTION POINTER 
PUSH H 

LHLD COUNT ; COUNT 

PUSH H 

LHLD АСТР у ACTUAL 

PUSH H 

LHLD BUFFP ; BUFFER POINTER 
PUSH H 

POP B 

LHLD GSTAT ; STATUS 

PUSH H 

POP D 
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TEST ERROR STATUS 


BRANCH TO EXCEPTION 
ROUTINE 


DIRECTORY IDENTIFIER 
DIRECTORY CONNECTION 
ENTRY COUNT 

POINTER TO ACTUAL 
POINTER TQ BUFFER 
POINTER TO STATUS 
COUNT OF ENTRIES READ 
CRETURNED) 

DIRECTORY BUFFER 
STATUS CRETURNED) 
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SPATH 
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The SPATH call allows your program to obtain information relating to specified 
files. The information returned by this call includes the device number, filename and 


extension, device type, and if a disk file, the drive type. 


You pass three parameters in the SPATH call: 


l. 


N 


The possible values for the contents of the info$p device number are 


path$p, the address of an ASCII string that contains the name of the file for 
which information is requested. The string can contain leading spaces but cannot 
contain embedded spaces. The string must be terminated by a character other 


than a letter, digit, colon (:), or period (.). A space can be used. 


info$p, the address of a 12-byte memory location in which the system will return 
the information. After the call is completed, the buffer will contain the following 


information: 


Byte 0— Device number 

Bytes | through 6—Filename 

Bytes 7 through 9—Filename extension 
Byte 10 —Device type 

Byte 11 —Drive type 


status$p, the address of a memory location for the return of a nonfatal error 


number. 
Nonfatal error codes returned: 4, 5, 23, 28 


Fatal error code returned: 33 


0— directory 0 

1—directory 1 

2— directory 2 

3— directory 3 

4—directory 4 

5— directory 5 

6—teletype input 

7—teletype output 

8—CRT input 

9 ——CRT output 
10—user console input 
11—user console output 
12—teletype paper tape reader 
13—high speed paper tape reader 
14—user reader | 

15—user reader 2 

16—teletype paper tape punch (teletype) 
17—high speed paper tape punch 
18—user punch 1 

19—user punch 2 
20—line printer 
21—user list 1 
22—byte bucket (a pseudo input/output device) 
23— console input 
24— console output 
25—directory 6 
26—directory 7 
27—directory 8 
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.28— directory 9 
29— spool printer queue (:SP:) 


Filename and extension are the ISIS filename, e.g., SAMPLE.SRC, without the 
period. 


Device type specifies the type of peripheral with which the file is associated. The 
possible values for this field are 


0—Sequential input device ; 
1 —Sequential output device 

2— Sequential input/output device 

3— Random access input/output device 


Drive type field specifies the type of drive controller if the device type field is 3. 
If the device type is anything except 3, the drive type is undefined. The possible 
values for a device type of 3 are 


0--СопігоПег not present 

1 —Two-board double density 

2—Two-board single density 

3—-Integrated single density 

4—Reserved 

5—-NDS-I remote mass storage (valid for NDS-I only) 
6—NDS-II remote mass storage (valid for NDS-H only) 
7— Reserved 

8—Unassigned 


CHAPTER 6 


SYSTEM CONSIDERATIONS 


This chapter describes useful ways to improve system performance and to avoid 
problems. 


Mainframe Link 


The Mainframe Link program RCOM80 running on the workstation can access only 
files at the local workstation; it cannot access files stored in the shared hard disk 
directories. 


1615-Ш(М) Command Files 


The system disk contains command program files of the same name as the 
ISIS-III(N) commands (DIR, COPY, DELETE, etc.). Do not interchange these files 
with any command program files from other versions of ISIS; the commands will not 
operate correctly. Use the VERS command to verify the version number and compat- 
ibility of the command program file. (See Chapter 4.) 


Home Directory 


When a new user is defined by the Superuser at the NRM, the user is assigned a 
home directory. Users can build a SUBMIT file called ISIS.INI in their home direc- 
tories. Commands in ISIS.INI will be executed automatically at LOGON time. 
Consequently, directory identifiers to commonly used pathnames are set up automat- 
ically without user involvement at LOGON time. 
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CHAPTER 7 


ERROR MESSAGES 


This chapter describes error codes and messages unique to the NDS-II operating 
system software. For descriptions of other 1515-ПІ(М) error codes and messages, see 
Appendix A of this manual. 


New ISIS-III(N) Error Messages 


61. DEVICE NOT ASSIGNED. 

The user has attempted to open a file on a logical device that has not been assigned 
to a directory. Use the ASSIGN command to map the device to the directory. 

63. SYNCHRONIZATION ERROR. 

Communication messages between ISIS and the Network Resource Manager are not 
synchronized. Reboot the ISIS software. 

64. NETHORK COMM ERROR. 


The Network Resource Manager communications board is malfunctioning or missing. 


65. LOCAL COMM ERROR. 


The Series II communications board is malfunctioning or missing. 


66. ILLEGAL ATTRIBUTE FOR REMOTE FILE. 

User has attempted to change the system, the format, or the invisible attribute on a 
network file. The write attribute is the only attribute supported on remote network 
files. Attributes are changed with the ATTRIB command or the ATTRIB system 
call. 

70. NETWORK FILE ACCESS RIGHT VIOLATION. 

User attempted to open a network file for read access without read access rights to 
the file. File access rights can be changed with the ACCESS command. 

71. ILLEGAL OPERATOR ON SHARED FILE. 

User attempted to write to a file that was being accessed by more than one user. 
When all other users have exited from the file, try again. 


72. MAXIMUM NUMBER OF FILES ON A DEVICE EXCEEDED. 


User attempted to create more than the maximum number of files allowed for a 
particular device. The maximum number of files per device is determined when the 
System Generation procedure is run. 


73. ATTEMPT TO DELETE A NON-EMPTY DIRECTORY. 


User attempted to delete a network directory that contains files. Delete all files in 
the directory before deleting the directory. 
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74. ILLEGAL NETWORK PATHNAME SYNTAX. 


User specified a fully qualified DFS pathname in a CREATE command and did not 
begin the pathname with a slash (/). АП fully qualified pathnames must begin with 
a slash (/). 


75. NON-TERMINATING PATH ELEMENT IS NOT A 
DIRECTORY. 


User specified a fully qualified pathname in a CREATE command where one of the 
first elements of the pathname was a data file. Only the final element of the pathname 
can be a data file. 


76. ATTEMPT TO CREATE A CONNECTED NETWORK FILE. 


User assigned :Fn: to /ROOT/A and then attempted to create /ROOT/A. No two 
directories can have the same pathname. 


77. USERNAME/PASSWORD MISMATCH. 


User attempted to log on with the valid username but an incorrect password. 


78. USERNAME NOT KNOWN. 


User attempted to log on with an unknown username. 


79. FILE ERROR ON SYSTEM FILE. 


The system accessed the user definition file. This file is a system file only. 


80. NETWORK FILE DETACHED, DEVICE DISMOUNTED. 


While a user was accessing a file, the device on which the file resided was dismounted 
or removed at the Network Resource Manager. 


81. MAXIMUM REMOTE ATTACHES EXCEEDED. 


User attempted to exceed the maximum number of files that could be attached at 
one time. The user can attach only 12 remote files at once. 


82. ILLEGAL PASSWORD SYNTAX. 


Attempt to log on with a password of more than 14 characters. 


83. ILLEGAL USERNAME SYNTAX. 


Attempt to log on with a username of more than 14 characters. 
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APPENDIX A 


SUMMARY OF ERROR MESSAGES 


This appendix provides a list of error codes and messages issued by ISIS-III(N), 
RUN, DEBUG-86, and some nonresident system routines. Other nonresident system 
routine error messages are listed in the /S7S-II User's Guide (see the Preface to this 
manual). 


Further explanations of the error codes can be found in other Intel manuals: 


Error Codes 


1-39 


40-60 


60-90 
101-149 


201-240 


Manuals 


ISIS-1I User's Guide, 9800306 
Intellec® Series ІП Microcomputer Development System 
Console Operating Instructions, 121609 


NDS-I Network Manager Operating Instructions, 121645 
NDS-I Workstation Operating Instructions, 121646 


NDS-II ISIS-III(N) User's Guide, 121765 


Intellec® Series III Microcomputer Development System 
Console Operating Instructions, 121609 


Intellec® Series ІП Microcomputer Development System 
Console Operating Instructions, 121609 


ISIS-III(N) Error Messages (8080/8085 Mode) 


FATAL ERROR. TOO FEW BUFFERS WERE ALLOCATED. 
ILLEGAL ACTIVE FILE TABLE NUMBER. 

FATAL ERROR. ACTIVE FILE TABLE IS FULL. 
INCORRECTLY SPECIFIED FILENAME. 

UNRECOGNIZED DEVICE NAME. 

ATTEMPT TO WRITE TO INPUT DEVICE. 

FATAL ERROR. THE DISK IS FULL. 

ATTEMPT ТО READ FROM OUTPUT DEVICE. 

DISK DIRECTORY IS FULL. 


«D COD -J4 CO) о - QJ ro — 


10. 


PATHNAME 


IS NOT ОМ SAME DISK. 


FILE ALREADY EXISTS. 


FILE 


IS ALREADY OPEN. 


МО SUCH FILE. 

WRITE-PROTECTED FILE ENCOUNTERED. 
FATAL ERROR. ISIS QVERWRITE. 
FATAL ERROR. BAD LOAD FORMAT. 
NOT A DISK FILE. 


ILLEGAL 


ISIS COMMANDS. 


ATTEMPTED SEEK ON NON-DISK FILE. 

ATTEMPTED BACK SEEK TOO FAR. 

CANNOT RESCAN. 

ILLEGAL ACCESS MODE TO OPEN. 

MISSING FILENAME. 

FATAL ERROR. DISK INPUT/OUTPUT HARDWARE ERROR. 
ILLEGAL ECHO FILE. 

ILLEGAL ATTRIBUTE IDENTIFIER. 

ILLEGAL SEEK COMMAND. 

MISSING EXTENSION. 


Summary of Error Messages 


FATAL ERROR. PREMATURE EOF. 

FATAL ERROR. DRIVE NOT READY. 

CANNOT SEEK ON WRITE ONLY FILE. 

CANNOT DELETE OPEN FILE. 

FATAL ERROR. ILLEGAL SYSTEM CALL PARAMETER. 
FATAL ERROR. INVALID RETURN SWITCH IN A LOAD 
SYSTEM CALL. 

SEEK PAST EOF. 

DEVICE NOT ASSIGNED. 

RESERVED. 

SYNCHRONIZATION ERROR. 

NETWORK COMM ERROR. 

LOCAL COMM ERROR. 

ILLEGAL ATTRIBUTE FOR REMOTE FILE. 

NETWORK FILE ACCESS RIGHT VIOLATION. 
ILLEGAL OPERATION ON SHARED FILE. 


MAXIMUM NUMBER OF FILES ON A DEVICE EXCEEDED. 


ATTEMPT TO DELETE A NON-EMPTY DIRECTORY. 
ILLEGAL NETWORK PATHNAME SYNTAX. 
NON-TERMINATING PATH ELEMENT IS NOT A 
DIRECTORY. 

ATTEMPT TO CREATE A CONNECTED NETWORK FILE. 
USERNAME/PASSWORD MISMATCH. 

USERNAME NOT KNOWN. 

FILE ERROR ON SYSTEM FILE. 

NETWORK FILE DETACHED, DEVICE DISMOUNTED. 
MAXIMUM REMOTE ATTACHES EXCEEDED. 

ILLEGAL PASSWORD SYNTAX. 

ILLEGAL USERNAME SYNTAX. 


NOTE 


When error 24 occurs, an additional message is displayed: 


STATUS=00nn 
Пах Tsyyy S*zzz 


where 


x represents the drive number. 
ууу the track address 

222 the sector address. 

nn has the following meanings: 


For flexible disks: 


01 Deleted record 

02 Data field CRC error 

03 Invalid address mark 

04 Seek error 

08 Address error 

0A ID field CRC error 

0E No address mark 

OF Incorrect data address mark 

10 Data overrun or data underrun 
20 Attempt to write on Write Protect 
40 Drive has indicated a Write error 
80 Drive not ready 
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For hard disks: 


01 ID field miscompare 

02 Data field CRC error 

04 Seek error 

08 Bad sector address 

04 ID field CRC error 

0B Protocol violations 

0с Bad track address 

0E No ID address mark or sector not found 
Я 0F Bad data field address mark 

10 Format error 

20 Attempt to write on write-protected drive 

40 Drive has indicated a write error 

80 Drive not ready 


RUN Program Error Messages (8086 Execution Mode) 


101. HARDWARE NOT RESPONDING (fatal error) 

102. INVALID SYNTAX 

103. COMMAND LINE TOO LONG 

104. INSUFFICIENT MEMORY TO LOAD 

105. MISMATCHED SOFTWARE/FIRMWARE 

106. ERROR 106 USER PC mmmm 
where mmmm is the contents of the program 
counter 

107. ILLEGAL LOAD ADDRESS 

108. INVALID OBJECT FILE 

117. UNRESOLVED SYMBOLS (warning) 

118. RAM FAILURE (warning) 

119. ROM CHECKSUM ERROR (warning) 


DEBUG-86 Error Messages (8086 Execution Mode) 


120. Syntax error 

121. Invalid token 

122. No such line 

123. Inappropriate number 
124. Partition bounds error 
125. Symbol already exists 
126. Symbol does not exist 
127. Memory failure 

133. Null string error 

134. Memory overflow 

135. Stack overflow 

136. Command too complex 
137. Module does not exist 
139, Excessive data 

141. Unsuitable execute file 
142. Line too long 

143. Too many partitions 
147. Pointer value required 
148. Integer value required 
149. Differing bases 
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Console Command Interface Errors (8080/8085 
Execution Mode) 


201. Unrecognized switch 

202. Unrecognized delimiter 

203. Invalid syntax 

206. Illegal disk label 

208. Checksum error 

209. Relo file sequence error 

210. Insufficient memory 

211. Record too long 

212. Illegal relo type 

213. Fixup bounds error 

214. Illegal SUBMIT parameter 

215. Argument too long 

216. Too many parameters 

217. Object record too short 

218. Illegal record format 

219. Phase error 

220. No EOF record in object module file 

221. Segment overflow during LINK operation 

222. Unrecognized record іп object module file 

223. Fixup record pointer is incorrect 

224. Illegal record sequence in object module file 
in LINK 

225. Illegal module name specified 

226. Module name exceeds 31 characters 

227. Command syntax requires left parenthesis 

228. Command syntax requires right parenthesis 

229. Unrecognized control specified in command 

230. Duplicate symbol found 

231. File already exists 

232. Unrecognized command 

233. Command syntax requires a TO clause 

234. Filename illegally duplicated in command 

235. File specified in command is not a library 
Tile 

236. More than 249 common segments in input files 

237. Specified common segment not found in object 
file 

238. Illegal stack content record in object file 

239. Но module header іп input object file 

240. Program exceeds 64K bytes 
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Table А-1. Nonfatal Error Numbers Returned by System Calls 


OPEN 
READ 
WRITE 
SEEK 
RESCAN 
CLOSE 
DELETE 
RENAME 
ATTRIB 
CONSOL 
WHOCON 
ERROR 
LOAD 
EXIT 
SPATH 
GETD 
GETATT 


System Call 


‚4,5, 9, 12, 13, 14, 22, 23, 25, 28, 52, 54, 61, 70 
; 19, 20, 27, 31, 35 
1 


, 13, 14, 17, 23, 28, 32, 61, 70 

a 5, 10, 11, 13, 17, 23, 28, 52, 54, 56, 61, 70 
4, 5, 13, 23, 26, 28, 52, 54, 61, 66, 70 

None; all errors are fatal. 

None 

None 

3, 4, 5, 12, 13, 22, 23, 28, 34, 61, 70 

None 

4, 5, 23, 28, 61, 70 

3, 4, 5, 13, 23 
4, 5, 13, 23, 28 


3 
2,8 
2,6 
2,1 
2,2 
2 

4,5 
4,5 


Table A-2. Fatal Errors Issued by System Calls 


1,7, 24, 30, 33, 51, 63, 64, 65 
24, 30, 33, 63, 64, 65 

7, 24, 30, 33, 63, 64, 65 

7, 24, 30, 33, 63, 64, 65 

33, 63, 64, 65 

33, 63, 64, 65 

1, 24, 30, 33, 63, 64, 65 

1, 24, 30, 33, 51, 63, 64, 65 
1, 24, 30, 33, 51, 63, 64, 65 
1, 4, 5, 12, 13, 14, 22, 23, 24, 28, 30, 33 
33 


33 
1, 15, 16, 24, 30, 33, 63, 64, 65 
33 


1, 24, 30, 33 
1, 24, 30, 33 
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COMMAND SYNTAX 


This appendix lists the ISIS-ITI(N) commands and syntax alphabetically. Chapter 4 
of this manual contains complete descriptions and examples of each command. 


ACCESS 
Еп: j А 

ACCESS | pathname! | filenamel switch] « c r > 

ASSIGN 
physical device name, 
network directory pathname, 

Ға: another directory identifier, 

ASSIGN 1 n || TH directory identifier and кыды 
pathname component, 
NULL 

ATTRIB 


ATTRIB [:Fn:1 filename Cattriblist]) [Gl«cr» 


CANCEL 


CANCEL queuename КЕ yee COPD 


COPY 


[: Fn: 1  outfile) 


COPY [:Fn:] ілйе (,...1 TO Шы 


| Г switches] «cr» 


CREATE 


:Fn: 


CREATE н 


| new directory name< cr > 


DELETE 


DELETE (:Fn:]1 filename [ ѕийсһеѕ] < сг» 


DIR 


DIR s шш! [TO Ийе) (switches) «cr? 
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EXPORT 


ЕИЗ 


EXPOR | pathname/ 


| filenamet ` € ` parameter list' )' ) TU queuename| е ч i 0 | «сг» 


FORMAT 


FORMAT :Fn:label Lswitches] «cr» 


IDISK 


IDISK :Fn: label [switches] «cr» 


IMPORT 


IMPORT FROM queuename L,queuenamel...«cr» 


LOGOFF 


LüGOüFF«cr» 


LOGON 
LOGON username<cr > 


password< cr > 


NETMAP 


NETMAP [x]<cr> 


QUEUE 


ADD 
QUEUE ( Stere (queuename [,...])¢cr> 


REMOVE 


Еп: 


REMOVE | pathname/ 


| directory name« сг > 


RENAME 


RENAME (:Fn:1 oldname TO 6(:Fn:1 newnameccr> 
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SPACE 


SPACE /volumename<cr > 


SUBMIT 


SUBMIT [:Fn:1 filename І (parameter 1, ...1)1<‹сг» 


SYSTAT 


QUEUE 
SYSTAT IE s] { диеиепате, queuename. ..1 «cr» 


VERS 


VERS command«cr? 


WHO 


WHO<cr> 
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SUMMARY OF ISIS-III(N) DEVICES 


This appendix alphabetically lists the devices that are accessible to the user from a 
workstation that is executing under the ISIS-III(N) operating system. 


:BB: Byte Bucket (a universal null device) (input/output) 
ІСІ: Current Console Device (input) 

:CO: Current Console Device (output) 

:FO: Directory (0) (input/output) 

:F1: Directory (1) (input/output) 

:F2: Directory (2) (input/output) 

:F3: Directory (3) (input/output) 

:Е4: Directory (4) (input/output) 

:F5: Directory (5) (input/output) 

:F6: Directory (6) (input/output) 

:F7: Directory (7) (input/output) 

;F8: Directory (8) (input/output) 

:F9: Directory (9) (input/output) 

:HP: Not supported 

:HR: Not supported 

:LP: Line Printer (output) | 
:SP: Spool Line Printer Queue (network output )* 
ТЇ; Not supported 

:TO: Not supported 

ТР: Not supported 

‘TR: Not supported 

МІ: Video Terminal Keyboard (input) 

:VO: — Video Terminal CRT Screen (output) 


*Indicates a device that is accessible only with the COPY, DELETE, or DIR 
commands. 
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Гог ff after а page number means “and the following page CHGACS, 5-4 


(or pages).” code conversion commands, 4-7 
б command 
#, 4-19 ACCESS, 4-9 
3 :Еп:, 4-2, 4-8 ASSIGN, 4-12 
:LP:, 4-2 ATTRIB, 4-17 
:ЅР:, 1-1, 4-2 CANCEL, 4-19 
% 8080/8085 programs, 4-5 categories, 4-3 
compatibility, 4-2 
aborted job, 4-57 COPY, 4-20 
ACCESS, 2-2, 3-4, 4-4, 4-9 CREATE, 4-25 
access DELETE, 4-27 
archiving files, 2-1 DIR, 4-29 
Q data files, 4-9 disk and directory maintenance, 4-3 
device, 1-5 entry, 1-6, 4-7 
directory file, 4-9 EXPORT, 4-33 
files, 1-6, 2-3, 3-3, 4-9 file maintenance, 4-4 
identifier, 4-9 FORMAT, 4-35 
network, 1-5, 4-2 IDISK, 4-37 
rights, 2-2, 4-4, 4-9, 4-47 IMPORT, 4-39 
owner, 4-9 LOGOFF, 4-41 
world, 4-9 LOGON, 4-42 
AEDIT, iii, 3-1 NETMAP, 4-44 
Q Assembly Language Calls, 5-2 network access, 4-3 
ASSIGN, 2-1, 2-3, 4-3, 4-12/ff, 4-45 program compatibility, 4-2, 6-1 
АТТКІВ, 2-2, 4-4, 4-17, 5-1, 5-3 program execution, 4-5 
attributes QUEUE, 4-47 
local, 2-2, 4-17 remote job execution, 1-5, 4-5 
available devices, 4-12, 4-44 REMOVE, 4-48 
RENAME, 4-50 
Board Set, Communications, 1-1, 1-3 sequence file, 4-33, 4-53 
branching SPACE, 4-52 
file structures, 2-3, 3-2, 3-4 SUBMIT, 4-55 
buffers syntax, 4-7 
Q SUBMIT, 4-54 SYSTAT, 456 
VERS, 4-59 
version, 4-2, 4-59 
cabled, Ethernet, 1-1, 1-4 WHO, 4-60 
calls, system, 5-1// Communication Controller Board Set, 1-1, 1-3 
ATTRIB, 5-3 Communications Module, 1-1, 1-3 
% CHGACS, 5-4 compatible 
console device assignment, 5-1 commands, 4-2 
DETIME, 5-6 configurations 
2 disk directory maintenance, 5-1 changing device, 4-44 
< FILINF, 5-8 supported, 4-12, 4-44 
СЕТАТТ, 5-11 Controller Board Set, Communications, 1-1 
GETD, 5-13 Conventions, vi 
input/output operations, 5-1 COPY, 4-4, 4-20 
program execution, 5-1 CREATE, 2-3, 4-3, 4-25 
SPATH, 5-16 creating 
summary, 5-1 directories, 2-3, 4-25 
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